Create a label

Creates a new label for the company. The label becomes available in the UI immediately and can be assigned to candidates via PATCH /campaign_invitations/{id}.

Duplicate prevention: If a label with the same name already exists, the API returns 409 Conflict. This is enforced both before saving and after, so a concurrent create with the same name still maps cleanly to 409 (never a 422 validation error).

Name rules: Names are trimmed of surrounding whitespace. Names containing ,, # or ? are rejected with 422.

Query Params
string
required

The API key provided for your application.

Body Params
label
object
required
Responses

401

Missing, invalid, or inactive API key.

500

Internal server error; the response may include an exception message.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json