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
    • PATCHProfiles
      • PUTCreate a parent worker relation
      • PUTCreate a parent worker relation with external id
      • POSTCreate a worker relation
      • PUTCreate child worker relation
      • PUTCreate child worker relation with external Id
      • POSTCreate worker relation type
      • POSTCreate worker relation with external Ids
      • DELDelete a worker relation
      • DELDelete a worker relation by external id
      • DELDelete a worker relation type
      • DELDelete a worker relation type by external id
      • GETFetch Worker Relations of a given HrisProfile by external id
      • GETList of worker relations
      • GETRetrieve all worker relation types
      • PATCHUpdate a worker relation type
      • PATCHUpdate a worker relation type by external id
LogoLogo
SupportDeel Home
EndpointsWorker Relations

Create a worker relation

POST
/hris/worker_relations/profile
POST
/rest/v2/hris/worker_relations/profile
$curl -X POST https://api.letsdeel.com/rest/v2/hris/worker_relations/profile \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "body": {
>    "data": {
>      "parent_hris_profile_id": "a3f1c9d2-4b7e-4f9a-8c3d-2e5f7b9a1c23",
>      "child_hris_profile_ids": [
>        "b4d2e1f3-5c6a-4d7b-9e8f-3a2b1c4d5e6f",
>        "c5e3f2a4-6d7b-5e8c-0f9a-4b3c2d5e6f7a"
>      ],
>      "hris_relationship_type_id": "d6f4a3b5-7e8c-0f9a-1b2c-3d4e5f6a7b8c"
>    }
>  }
>}'
1{}

Establishes a hierarchical relationship between a worker and one or more subordinates. The request body must identify both the parent worker and the subordinate profiles to be linked. Token scopes: profile:write

Was this page helpful?
Previous

Create child worker relation

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

This endpoint expects an object.
dataobjectOptional
The request payload containing the relationship details.

Response

Successful operation

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
500
Internal Server Error

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