Create an engagement
Creates an IC contract, applies the client signature, and invites the worker, in one idempotent call. Retry with the same Idempotency-Key to resume after a partial failure.
Token scopes: contracts:write
Beta: this version requires the X-Beta: true request header and its contract may change before it is promoted to stable. It is scheduled to become stable on 2027-02-09.
Authentication
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.
curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \
-H 'Authorization: Bearer YOUR-TOKEN-HERE'
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/
Headers
A v4 UUID. Reusing the same key with the same body resumes an in-progress or partially-failed engagement instead of creating a duplicate.
Opts in to the beta version of this endpoint. Must be true.
Request
POST /rest/contracts data (legal_entity_id/team_id flattened - a nested id property is rejected as a server-generated field; job_title omitted - undocumented for that endpoint), plus client_signature and actions. See each field below for whether it is required.