Tag a Candidate by Tag Title
A 4-step recipe with Ashby. We can help you get access.
Recipe · 4 steps
Tag a Candidate by Tag Title
with Ashby · Talent Acquisition Management
Resolve or create a candidate tag by title and apply it to a candidate.
- List the organization's candidate tags so the supplied title can be resolved to a tag id without creating a duplicate. Archived tags are excluded so a retired tag is not silently reused.
- Create the tag. Ashby returns the existing tag when one already has this title, so this call is safe even if the listing above was paginated and the match was missed.
- Apply the resolved tag to the candidate.
- Read the candidate back and return the full tag set so the caller can confirm the tag landed alongside any tags already present.
What you'll need to have ready
- candidateId: The unique id of the candidate to tag.
- tagTitle: The title of the tag to apply (e.g. "Strong candidate").
For your developer
Arazzo workflow ashby-hq:candidate-tagging, 4 operations: candidateTagList → candidatetagcreate → candidateAddTag → candidateInfo. Specs on APIs.io.