Send an email draft to a candidate
Sends an email draft the authenticated user wrote, once they have confirmed its preview. A draft is sent at most once, so repeating the call never emails the candidate twice. Sending is irreversible.
Token scopes: ats:write, worker: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-01-29.
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.
curl -X GET 'https://api.deel.training/rest/v2/contracts' \
-H 'Authorization: Bearer YOUR-TOKEN-HERE'
OR
AuthorizationBearer
Standard OAuth2 security scheme based on https://swagger.io/docs/specification/authentication/
Path parameters
candidate_id
ID of the candidate the draft is addressed to
Headers
X-Beta
Opts in to the beta version of this endpoint. Must be true.
Allowed values:
Request
This endpoint expects an object.
data
Response
The email sent from the draft, or the email already sent when the draft was sent before
data
The email sent from the draft
Errors
400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
500
Internal Server Error