Add Tag to Candidate

POST

/api/v1/client/candidates/add-tag/

Last modified:2025-12-30 13:07:46

Adds a tag to an existing candidate via integration (n8n, Zapier, Make, etc.).

Arguments

candidate_id (integer, as body parameter, required) : The unique identifier of the candidate.

Example: 123

title (string, as body parameter, required) : The tag title to add.

Example: "Top Candidate"

Returns

201 Created : A JSON object representing the created tag, including its ID and title.

404 Not Found : If the candidate does not exist or does not belong to the authenticated company.

409 Conflict : If the tag already exists for this candidate.

Request

Authorization

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Body

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.recruspace.com/api/v1/client/candidates/add-tag/' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "candidate_id": 0,
    "title": "string"
}'

Response Example

{
    "id": 0,
    "title": "string"
}

Modified at 2025-12-30 13:07:46

Add Note to Candidate

Add Candidate to Job Post or Talent Pool