---
title: "candidateTag.create"
method: POST
path: "/candidateTag.create"
tags: ["Candidate Tag"]
---

# candidateTag.create

`POST /candidateTag.create`

Creates a candidate tag.

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

**Requires the [`hiringProcessMetadataWrite`](authentication#permissions-candidatetagcreate) permission.**

## Request body

- CandidateTagCreateRequest
  - `title` string, required — The tag's title. If a tag already exists with that title, the existing tag will be returned.

## Response `200`

Responses from the candidateTag.create endpoint

- union
  - CandidateTagCreateSuccessResponse
    - `success` true, required
    - `results` CandidateTag, required
      - `id` string, uuid, required — The candidate tag's unique identifier
      - `title` string, required — The tag's title
      - `isArchived` boolean, required — Whether the tag has been archived
  - ErrorResponse
    - `success` false, required
    - `errors` ErrorDetail[], required
      - `message` string, required
      - `parameter` string

---

[API](https://skmtc.net/ashbyhq/apis/ashby-api.md) · [All operations](https://skmtc.net/ashbyhq/apis/ashby-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ashbyhq/ashby-api/revisions/778b919dc743/schema)