> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Create Account Tag

> Add a tag to your account vocabulary

Creates an account tag. Account tags label **companies**. Connector tags, which label people, are a
separate vocabulary with its own endpoints.

A name your workspace already uses is rejected rather than duplicated, so this
is safe to call from a sync that does not track what it has already created.

## Body

<ParamField body="name" type="string" required>
  1-50 characters. Unique within your workspace.
</ParamField>

<ParamField body="color" type="string" required>
  A hex colour, e.g. `#3B82F6`. Rendered through a normaliser that caps
  saturation and clamps lightness, so a neon value will display calmer than you
  sent it — deliberately, so one workspace's palette cannot dominate a screen.
</ParamField>

<ParamField body="position" type="integer">
  Display position. Omitted means the end of the list, which is where a new tag
  belongs: appending never renumbers anything you have already arranged.
</ParamField>

<Note>
  **A workspace is capped at 50 tags.** Not a storage limit — a flat picker
  stops being scannable past a few dozen, and at that point what you want is a
  second dimension rather than a hundredth tag.
</Note>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.clustr-ai.com/api/public/account-tags" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "Common investor", "color": "#3B82F6"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "data": {
      "tag": {
        "id": "7f3e1a22-...",
        "name": "Common investor",
        "color": "#3B82F6",
        "position": 4
      }
    }
  }
  ```

  ```json 400 theme={null}
  {
    "success": false,
    "error": {
      "message": "a tag with this name already exists",
      "code": "BAD_REQUEST"
    }
  }
  ```
</ResponseExample>