Create Stage
Deals
Create a Stage
POST
Create Stage
key is derived automatically from name (lowercased, non-alphanumerics collapsed to _). is_closed is set to is_won OR is_lost.
When position is omitted, the stage is placed immediately after the last non-terminal stage and before Won/Lost — any stage already at or past that slot is shifted up by one first, since (org_id, position) isn’t a unique constraint and a tie would sort unpredictably.
Auth
Requires the org-admin scopeorganizations:manage specifically — the CRM manage scopes the rest of the deals router accepts are not enough here — plus an active organization on the token.
Response
The created stage row — same shape as List All Stages.Errors
Authorizations
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Body
application/json
Stage name, shown on the pipeline board.
Required string length:
1 - 80Hex color for the stage chip/column.
Default win probability for deals in this stage, 0.0-1.0.
Required range:
0 <= x <= 1Mark this as the (or a) Closed Won terminal stage.
Mark this as the (or a) Closed Lost terminal stage.
Sort position; defaults to just before the terminal stages when omitted.
Response
Successful Response