> ## 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 Partner Stage

> Create a new partner stage for the partnership pipeline

## Authentication

<CodeGroup>
  ```bash cURL theme={null}
  curl -X POST "https://app.journeybee.io/api/v1/stages/partner-stages" \
    -H "Authorization: Bearer your-api-key-uuid" \
    -H "Content-Type: application/json" \
    -d '{"label": "Under Review", "partner_type": "referral", "phase": "evaluation"}'
  ```
</CodeGroup>

## Request Body Schema

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

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

<ParamField body="phase" type="string">
  Stage phase category. Options: `discovery`, `evaluation`, `active`, `inactive`
</ParamField>

<ParamField body="series" type="number">
  Stage order/sequence (auto-assigned if not provided)
</ParamField>

## Response Schema

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

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

## Notes

* Requires API key with `write_access` permission
* Series is auto-calculated if not provided