For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
SupportDeel Home
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
OverviewPlatformEmployer of RecordContractorsGlobal PayrollHREmbeddedDeel ITAPI ReferenceChangelog
  • Resources
    • Blog
    • Community
    • API spec
  • Endpoints
      • POSTCreate an EOR contract
      • GETRetrieve EOR Contract Details
      • PATCHUpdate EOR Contract
    • PATCHProfiles
LogoLogo
SupportDeel Home
EndpointsEor Contract

Create an EOR contract

POST
/eor
POST
/rest/v2/eor
$curl -X POST https://api.letsdeel.com/rest/v2/eor \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "body": {
>    "data": {
>      "client": {
>        "team": {
>          "id": "team-12345"
>        }
>      },
>      "employee": {
>        "last_name": "Doe",
>        "first_name": "John",
>        "nationality": "US",
>        "email": "john.doe@example.com",
>        "address": {
>          "zip": "80202",
>          "city": "Denver",
>          "state": "CO",
>          "street": "1234 Elm Street",
>          "country": "US"
>        },
>        "external_id": "ext-employee-001"
>      },
>      "job_title": "Software Engineer",
>      "seniority": {
>        "id": "seniority-123"
>      },
>      "employment": {
>        "country": "US",
>        "start_date": "2024-01-15",
>        "scope_of_work": "Develop and maintain backend services for the company’s main product, ensuring scalability and reliability.",
>        "work_visa_required": false,
>        "type": "Full-time",
>        "state": "CO",
>        "end_date": "2025-01-14",
>        "holidays": 15,
>        "is_hourly": false,
>        "time_off_type": "STANDARD",
>        "seniority_date": "2020-01-15",
>        "sick_leave_days": 10,
>        "probation_period": 90,
>        "notice_period_type": "STANDARD",
>        "work_hours_per_week": 40,
>        "probation_period_time_unit": "DAY",
>        "notice_period_after_probation": 30,
>        "notice_period_during_probation": 14,
>        "employee_completed_past_probation": false,
>        "probation_period_type_for_definite": "STANDARD",
>        "notice_period_after_probation_time_unit": "DAY",
>        "notice_period_during_probation_time_unit": "DAY"
>      },
>      "compensation_details": {
>        "currency": "USD",
>        "salary": 120000,
>        "variable_compensation": 10,
>        "variable_compensation_type": "PERCENTAGE",
>        "variable_compensation_title": "Annual Bonus",
>        "variable_compensation_timeline": "ANNUALLY",
>        "variable_compensation_effective_date": "2024-01-01",
>        "signing_bonus": 5000,
>        "signing_bonus_payout_type": "AFTER_PROBATION",
>        "fixed_adjustments": [
>          {
>            "name": "Internet Allowance",
>            "value": 100,
>            "opt_out": false,
>            "optional": true,
>            "description": "Monthly internet reimbursement",
>            "is_recurring": true,
>            "rule_cost_id": "rule-cost-123",
>            "is_country_specific": true,
>            "skipping_confirmation_text": "Confirm skipping internet allowance"
>          }
>        ]
>      }
>    }
>  }
>}'
1{
2  "data": {
3    "id": "eor-98765",
4    "type": "eor",
5    "costs": {
6      "summary": {
7        "salary": "120,000.00",
8        "currency": "USD",
9        "exchange_rate": "1.00",
10        "totals_formatted": [
11          {
12            "title": "Monthly total",
13            "total": "10,500.00",
14            "frequency": "monthly",
15            "total_supporting": "10,500.00"
16          }
17        ],
18        "supporting_currency": "USD"
19      },
20      "sections": [
21        {
22          "name": "MONTHLY_EMPLOYMENT_BREAKDOWN",
23          "label": "Monthly employment breakdown",
24          "groups": [
25            {
26              "name": "GROSS_MONTHLY_SALARY",
27              "costs": [
28                {
29                  "label": "Salary",
30                  "totals": [
31                    {
32                      "total": "10,000.00",
33                      "frequency": "monthly",
34                      "total_supporting": "10,000.00"
35                    }
36                  ]
37                }
38              ],
39              "label": "Gross salary",
40              "totals": [
41                {
42                  "total": "10,000.00",
43                  "frequency": "monthly",
44                  "total_supporting": "10,000.00"
45                }
46              ],
47              "has_breakdown": true
48            }
49          ],
50          "totals": [
51            {
52              "total": "10,500.00",
53              "frequency": "monthly",
54              "total_supporting": "10,500.00"
55            }
56          ],
57          "is_summarized": true,
58          "standalone_items": [
59            {
60              "name": "One off payment",
61              "label": "Printed Agreement handling fee",
62              "totals": [
63                {
64                  "total": "80.00",
65                  "frequency": "one-time",
66                  "total_supporting": "80.00"
67                }
68              ]
69            }
70          ]
71        }
72      ],
73      "additional_data": {
74        "annual_notes": [
75          "Annual salary includes base pay and expected bonuses."
76        ],
77        "monthly_notes": [
78          "Monthly totals include base salary and fixed adjustments."
79        ],
80        "once_off_notes": [
81          "One-time fees apply for onboarding and agreement processing."
82        ],
83        "additional_notes": [
84          "Kindly note that the onboarding process for employees in this country requires the completion of a QES (Qualified Electronic Signature) process, which carries a fee of $80 USD. This fee is designed to cover the additional administrative expenses associated with the QES process. In the event that the QES option is not available, an alternative would be to proceed with a printed agreement signature process, incurring costs of $80 USD. These costs include expenses for printing, shipping, and handling related to the signing of the printed agreement.",
85          "Deel can countersign the employment agreement once you provide a Qualifying Electronic Signature (QES). After the employee registers on the Deel platform, we will notify and invite you to sign the Scope of Work, through the QES process. Please note that we are unable to proceed with your employee full onboarding until you complete this QES signing step."
86        ]
87      }
88    },
89    "client": {
90      "legal_entity": {
91        "name": "Acme Corporation"
92      }
93    },
94    "status": "new",
95    "employee": {
96      "email": "john.doe@example.com",
97      "last_name": "Doe",
98      "first_name": "John",
99      "legal_name": "Johnathan Doe"
100    },
101    "job_title": "Software Engineer",
102    "seniority": {
103      "id": 3,
104      "name": "Mid-level"
105    },
106    "created_at": "2024-01-15T09:30:00Z",
107    "employment": {
108      "state": "CO",
109      "country": "US",
110      "end_date": "2025-01-14T00:00:00Z",
111      "start_date": "2024-01-15T00:00:00Z",
112      "scope_of_work": "Develop and maintain backend services for the company’s main product, ensuring scalability and reliability.",
113      "time_off_type": "STANDARD",
114      "probation_period": 90,
115      "work_visa_required": false,
116      "calculated_holidays": 15
117    },
118    "health_plan": {
119      "id": "hp-45678",
120      "name": "Standard Health Coverage"
121    },
122    "compensation_details": {
123      "salary": "120000",
124      "currency": "USD",
125      "variable_compensation": "10",
126      "variable_compensation_type": "PERCENTAGE"
127    }
128  }
129}

Submits details for an Employee of Record (EOR) contract and returns a quote. Deel processes the submitted information and returns pricing, compensation, and health plan details before the contract is activated. Token scopes: contracts:write

Was this page helpful?
Previous

Retrieve EOR Contract Details

Next
Built with

Authentication

AuthorizationBearer

Authentication

The Deel API uses bearer tokens to authenticate requests. All API calls must be made over HTTPS — calls over plain HTTP or without authentication will fail.

1curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
2  -H 'Authorization: Bearer YOUR-TOKEN-HERE'

Learn more about authentication

OR
AuthorizationBearer
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/

Request

The details of the Employee (EOR) contract to be created.

dataobjectRequired

Response

Successfully created the EOR contract quote.
dataobject

Errors

401
Unauthorized Error
403
Forbidden Error
404
Not Found Error

Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/