> ## 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 Tier

> Create a new partner tier for managing partnership levels

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.journeybee.io/api/v1/tiers" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json" \
    -d '{"label": "Platinum", "background_color": "#E5E7EB", "text_color": "#000000", "partner_type": "referral"}'
  ```
</CodeGroup>

## Request Body Schema

<ParamField body="label" type="string" required>
  Tier name
</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 tier ID
</ResponseField>

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

## Notes

* Requires API key with `write_access` permission
* Tiers help categorize partners by performance or commitment level
* Colors must be valid hex color codes