cURL
Python
JavaScript
PHP
Go
Java
curl --request POST \
--url https://api.kombo.dev/v1/ats/candidates/{ candidate_id} /tags \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--header 'X-Integration-Id: <x-integration-id>' \
--data '{
"tag": {
"name": "Excellent Fit"
}
}'
{
"status" : "success" ,
"data" : { }
}
Kombo takes care of creating the tag if required, finding out the right ID, and appending it to the list of tags.
This endpoint requires the permission Manage tags to be enabled in your scope config .
Example Request Body
Create an API key on the Secrets page in the Kombo dashboard.
ID of the integration you want to interact with.
The Kombo ID of the candidate you want to add the tag to.
POST /ats/candidates/:candidate_id/tags request body
The name of the tag you would like to add. We will automatically find the matching ID of the tag in the system.
Minimum length: 1
Additional fields that we will pass through to specific ATS systems.
Fields specific to Greenhouse.
remote_fields.greenhouse. post_headers
Headers we will pass with POST
requests to Greenhouse.
remote_fields.greenhouse.post_headers. On-Behalf-Of
ID of the the user that will show up as having performed the action in Greenhouse. We already pass a value by default, but you can use this to override it.
POST /ats/candidates/:candidate_id/tags Successful response
Available options:
success