Skip to main content
POST
/
api
/
v1
/
stages
/
lead-deal-stages
Create Deal Stage
curl --request POST \
  --url https://app.journeybee.io/api/v1/stages/lead-deal-stages \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "label": "<string>",
  "partner_type": "<string>",
  "phase": "<string>",
  "series": 123
}
'
{
  "id": 123,
  "uuid": "<string>"
}

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.

​
Authentication

curl -X POST "https://app.journeybee.io/api/v1/stages/lead-deal-stages" \
  -H "Authorization: Bearer your-api-key-uuid" \
  -H "Content-Type: application/json" \
  -d '{"label": "Demo Scheduled", "partner_type": "referral", "phase": "discovery"}'

​
Request Body Schema

​
label
string
required
Stage name/label
​
partner_type
string
Partner type association. Options: referral, reseller
​
phase
string
required
Stage phase category. Options: discovery, negotiation, closed_won, closed_lost
​
series
number
Stage order/sequence (auto-assigned if not provided)

​
Response Schema

​
id
number
The created stage ID
​
uuid
string
The created stage UUID

​
Notes

  • Requires API key with write_access permission
  • Phase determines commission calculation logic