> ## 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 Opportunity Status

> Create a new opportunity status for your workspace

<Warning>
  **Deprecated — a status is a [tag](/tags).** This creates a tag in the `path`
  group named Status. Use [Create Tag](/api-reference/create-tag) with that
  group's `group_id`, from [List Tag Groups](/api-reference/list-tag-groups).

  A workspace with no Status group answers `400`: there is no group to create
  it in, so create the group first.
</Warning>

## Body

<ParamField body="name" type="string" required>
  Up to 50 characters.
</ParamField>

<ParamField body="color" type="string" required>
  A hex color, e.g. `#3B82F6`.
</ParamField>

<ParamField body="position" type="integer">
  Display position. Omitted means the end of the list.
</ParamField>

<ParamField body="is_terminal" type="boolean">
  Marks this a closed status: rows carrying it sort last and draw with a
  neutral pill, but stay visible — a status never hides a row. See [Account
  States](/account-states).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X POST "https://api.clustr-ai.com/api/public/opportunity-statuses" \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{"name": "Meeting booked", "color": "#22C55E"}'
  ```
</RequestExample>

<ResponseExample>
  ```json 201 theme={null}
  {
    "success": true,
    "data": {
      "id": "5e6f7a8b-...",
      "name": "Meeting booked",
      "color": "#22C55E",
      "position": 4,
      "is_terminal": false
    }
  }
  ```

  ```json 401 theme={null}
  {
    "success": false,
    "error": { "message": "Invalid or missing API key", "code": "UNAUTHORIZED" }
  }
  ```
</ResponseExample>