Add Candidate | Deel | Documentation

Add a candidate to Deel. Token scopes: candidates:write

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.

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

Learn more about 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 curl -X GET 'https://api.letsdeel.com/rest/v2/contracts' \ -H 'Authorization: Bearer YOUR-TOKEN-HERE' ``` [Learn more about authentication](/api/authentication)

AuthorizationBearer

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

Request

Add a candidate to Deel

dataobjectRequired

Details of candidate to create

Response

Successful operation.

dataobject

1	import requests
2
3	url = "https://api.letsdeel.com/rest/v2/candidates"
4
5	payload = { "data": {
6	"id": "123456",
7	"link": "https://atsexample.com/profile/id",
8	"status": "offer-accepted",
9	"last_name": "Doe",
10	"first_name": "John",
11	"start_date": "2022-12-31"
12	} }
13	headers = {
14	"Authorization": "Bearer <token>",
15	"Content-Type": "application/json"
16	}
17
18	response = requests.post(url, json=payload, headers=headers)
19
20	print(response.json())

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

1	{
2	"data": {
3	"created": true
4	}
5	}

Authentication

Authentication

Request

Response

Errors

Authentication