v1

latestOpenAPI 3.1.02026-07-261770816.7 KB
Applied Candidate Tags

Create applied candidate tag

Apply an existing tag to a candidate. Both candidate_id and candidate_tag_id are required; the tag must already exist in the organization's candidate-tag dictionary (create it via POST /v3/candidate_tags first if needed). Applying a tag a candidate already has is idempotent at the data level but returns a 422 on duplicate. This replaces V1's batch PUT /v1/candidates/{id}/tags workflow — to attach multiple tags, issue one POST per tag.

post/v3/applied_candidate_tags

Request body

candidate_idinteger required
candidate_tag_idinteger required

Response

Successful

idinteger
created_atstring date-time
updated_atstring date-time
candidate_tag_idinteger

Id of the tag in your organization's candidate-tag dictionary. References a /v3/candidate_tags row.

candidate_idinteger

Id of the candidate (person) the tag is applied to.