---
title: "Create a contact tag"
method: POST
path: "/contact-tags"
tags: ["Contact Tags"]
---

# Create a contact tag

`POST /contact-tags`

Creates a tag. A brand color is auto-assigned when none is provided. Tag names are unique per account.

## Request body

- object
  - `name` string, required
  - `color` string — Optional brand palette hex color; auto-assigned when omitted.

## Response `201`

Tag created successfully

- ContactTag
  - `id` integer
  - `user_id` integer
  - `name` string, required
  - `color` string — Brand palette hex color (e.g. "#FF644D").
  - `contacts_count` integer — Number of contacts carrying the tag (included on list/show).
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401` — Unauthorized
- `422` — Validation error (duplicate name or invalid color)

---

[API](https://skmtc.dev/sendfox/apis/sendfox-api.md) · [All operations](https://skmtc.dev/sendfox/apis/sendfox-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sendfox/sendfox-api/revisions/c5728da3037f/schema)