Skip to main content

StageCreate

A stage is a position in a product's pipeline. Leads occupy exactly one stage at a time. Analytics roles/outcomes on stages drive the dashboard funnel rollups.

product_idProduct Idrequired

ID of the product (workspace) that owns this record. Most endpoints scope access by product.

nameNamerequired

Human-readable stage name.

positionPositionrequired

Ordering of the stage within the pipeline (lower comes first).

analytics_role object

Role of the stage in funnel analytics — entry, progress, terminal, or ignore.

anyOf
StageAnalyticsRole

Possible values: [entry, progress, terminal, ignore]

analytics_outcome object

For terminal stages, the business outcome — success, escalation, refusal, disqualified, or other.

anyOf
StageAnalyticsOutcome

Possible values: [success, escalation, refusal, disqualified, other]

StageCreate
{
  "product_id": 0,
  "name": "string",
  "position": 0,
  "analytics_role": "entry",
  "analytics_outcome": "success"
}