Add a Tag to a Candidate

📘
Tags in ATS Systems

Tags in ATS vary across systems, with some supporting tags at the candidate level and others at the application level. We strive to create tags at the application level wherever supported. If not, we will add them at the candidate level.

When creating new tags, you can pass a dummy ID in place of the tag ID if you don't have the ID of any existing tag obtained from List Global Tags or List Candidate Tags. Some ATS systems support tag IDs, while others rely on tag text only. If you have the tag ID, pass it; otherwise, a dummy string can be used.

Supported Apps

Here are the list of apps that support this API.

Greenhouse (greenhouse)

SmartRecruiters (smartrecruiters-ats)

SAP SuccessFactors (successfactors-ats)

Darwinbox (darwinbox-ats)

Workday (workday-ats)

Remarks: The tag must be added to global tags through dashboard. Then only it can be added to candidate.

Lever (lever)

Workable (workable)

Remarks: There are few limitations on workable tags:

Ignores everything after whitespace character an lowercases character in tag. Eg. "Knit Tag" -> "knit", "Knit" -> "" (No tag), "test_tag" -> "test_tag" ("-" accepted as separator).
Tag length should be less than 25 characters otherwise tag will not be applied. Eg. "test_tag_tag_test_tag_te" -> Accepted within 25 char "test_tag_tag_test_tag_test_tag_test" -> Ignored.
It is recommended to see related document or check with workable dashboard in case of any other limitation. Tags in workable

TeamTailor (teamTailor)

Breezy HR (breezy)

Ashby (ashby)

Zoho Recruit (zoho-recruit)

JazzHR ATS (jazzhr-ats)

Recruitee (recruitee)

iCIMS (icims)

Pinpoint (pinpoint)