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

# Create Tag

> Create a new tag for organizing leads, deals, or partners

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.journeybee.io/api/v1/tags" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json" \
    -d '{"label": "VIP Client", "association": "lead", "background_color": "#10B981", "text_color": "#FFFFFF"}'
  ```
</CodeGroup>

## Request Body Schema

<ParamField body="label" type="string" required>
  Tag label/name
</ParamField>

<ParamField body="association" type="string" required>
  What this tag applies to. Options: `lead`, `lead_deal`, `partner`, `card`
</ParamField>

<ParamField body="background_color" type="string">
  Background color (hex format, default: #6B7280)
</ParamField>

<ParamField body="text_color" type="string">
  Text color (hex format, default: #FFFFFF)
</ParamField>

<ParamField body="partner_type" type="string">
  Partner type association. Options: `referral`, `reseller`
</ParamField>

## Response Schema

<ResponseField name="id" type="number">
  The created tag ID
</ResponseField>

<ResponseField name="uuid" type="string">
  The created tag UUID
</ResponseField>

## Notes

* Requires API key with `write_access` permission
* Colors must be valid hex color codes
* Tags help with visual organization and filtering