Sign in

v1

latestOpenAPI 3.1.02026-07-24181585937.4 KB
Candidate Tag

candidateTag.create

Creates a candidate tag.

If a tag already exists with the given title, the existing tag will be returned.

Requires the hiringProcessMetadataWrite permission.

post/candidateTag.create

Request body

titlestring required

The tag's title. If a tag already exists with that title, the existing tag will be returned.

Example request

{
  "title": "Strong candidate"
}

Response

Responses from the candidateTag.create endpoint

OR

Example response

{
  "success": true,
  "results": {
    "id": "e9ed20fd-d45f-4aad-8a00-a19bfba0083e",
    "title": "Strong candidate",
    "isArchived": false
  }
}