Create candidate tags | Deel

Replaces all existing tags on a candidate with the provided set of tag_ids. This is a full replacement — any tags not included in the request body will be removed. Token scopes: ats: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. ```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/

Path parameters

candidate_idstringRequiredformat: "uuid"

The unique identifier of the candidate.

Request

This endpoint expects an object.

tag_idslist of stringsRequired

List of tag IDs to associate with the candidate

Response

Successfully created

datalist of objects

List of created candidate-tag associations.

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

500

Internal Server Error

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

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

The unique identifier of the candidate.

This endpoint expects an object.

List of tag IDs to associate with the candidate

Successfully created

List of created candidate-tag associations.

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

$	curl -X POST https://api.letsdeel.com/rest/v2/ats/candidates/c3d4e5f6-a7b8-9012-cdef-123456789012/tags \
>	-H "Authorization: Bearer <token>" \
>	-H "Content-Type: application/json" \
>	-d '{
>	"tag_ids": [
>	"string"
>	]
>	}'

1	{
2	"data": [
3	{
4	"id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
5	"tag_id": "b2c3d4e5-f6a7-8901-bcde-f12345678901",
6	"created_at": "2026-02-26T12:00:00.000Z",
7	"candidate_id": "c3d4e5f6-a7b8-9012-cdef-123456789012"
8	}
9	]
10	}

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