v3

latestOpenAPI 3.1.02026-07-311255771.3 MB
Unified ATS API

Add tag to candidate

Add a tag to a candidate.

Kombo takes care of creating the tag if required, finding out the right ID, and appending it to the list of tags.

<Note> This endpoint requires the permission **Manage tags** to be enabled in [your scope config](/scopes). </Note>

Example Request Body

{
  "tag": {
    "name": "Excellent Fit"
  }
}
post/ats/candidates/{candidate_id}/tags

Path parameters

candidate_idstring required

The Kombo ID of the candidate you want to add the tag to.

The Kombo ID of the candidate you want to add the tag to.

Headers

X-Integration-Idstring required

ID of the integration you want to interact with.

Request body

Response

POST /ats/candidates/:candidate_id/tags Positive response

status'success' required
dataobject required

Example response

{
  "data": {}
}