---
title: "Create Tag"
method: POST
path: "/tags"
tags: ["Tags"]
---

# Create Tag

`POST /tags`

Create a new tag.

## Request body

- object
  - `name` string, required — The name of the tag
  - `organizationId` string, required — The organization this tag belongs to.
  - `agentVisibility` 'LEAD_PROFILES' | 'OPT_OUT' | 'NEVER', required — The context in which an agent can see and collect tags. LEAD_PROFILES: Agents will be able to see these while sending messages and use them to collect info about contacts. OPT_OUT: Specifically for opt-out reasons. Will only be displayed when agents opt out a contact. NEVER: Only for admins. Agents will never see this tag.

## Response `201`

Returns the created Tag.

- object
  - `items` Tag[], required — List of tags matching the query.
    - `id` string, required — The tag's ID.
    - `type` 'tag', required — The type of this object.
    - `name` string, required — The tag name/label that shows up in the UI.
    - `organizationId` string — The organization this tag belongs to.
    - `createdAt` string, required — An ISO-8601 string representing the date the tag was created.
    - `agentVisibility` 'LEAD_PROFILES' | 'OPT_OUT' | 'NEVER', required — The context in which an agent can see and collect tags. LEAD_PROFILES: The default use. Agents will be able to see these while sending messages and use them to collect info about contacts. OPT_OUT: Specifically for opt-out reasons. Will only be displayed when agents opt out a contact. NEVER: Only for admins. Agents will never see this tag.
  - `cursor` string, nullable, required — Cursor for start of next set of items. If there were no items to return with the last cursor you passed, this will return null.
  - `hasMore` boolean, required — Whether there are more items to load past this cursor.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

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