Stage is a logical component of a pipeline, and essentially a bucket that can hold a number of deals. In the context of the pipeline a stage belongs to, it has an order number which defines the order of stages in that pipeline.
/v1/stages
Returns data about all stages.
pipeline_id
integer
The ID of the pipeline to fetch stages for. If omitted, stages for all pipelines will be fetched.
start
integer
Pagination start
Default
0
limit
integer
Items shown per page
OK
/v1/stages/{id}
Returns data about a specific stage.
id
integer
required
The ID of the stage
everyone
number
If everyone=1
is provided, deals summary will return deals owned by every user
Values
0
1
OK
/v1/stages/{id}/deals
Lists deals in a specific stage.
id
integer
required
The ID of the stage
filter_id
integer
If supplied, only deals matching the given filter will be returned
user_id
integer
If supplied, filter_id
will not be considered and only deals owned by the given user will be returned. If omitted, deals owned by the authorized user will be returned.
everyone
number
If supplied, filter_id
and user_id
will not be considered – instead, deals owned by everyone will be returned
Values
0
1
start
integer
Pagination start
Default
0
limit
integer
Items shown per page
OK
/v1/stages
Adds a new stage, returns the ID upon success.
application/json
name
string
required
The name of the stage
pipeline_id
integer
required
The ID of the pipeline to add stage to
deal_probability
integer
The success probability percentage of the deal. Used/shown when deal weighted values are used.
rotten_flag
boolean
Whether deals in this stage can become rotten
Values
true
false
rotten_days
integer
The number of days the deals not updated in this stage would become rotten. Applies only if the rotten_flag
is set.
OK
/v1/stages/{id}
Updates the properties of a stage.
id
integer
required
The ID of the stage
application/json
name
string
The name of the stage
pipeline_id
integer
The ID of the pipeline to add stage to
deal_probability
integer
The success probability percentage of the deal. Used/shown when deal weighted values are used.
rotten_flag
boolean
Whether deals in this stage can become rotten
Values
true
false
rotten_days
integer
The number of days the deals not updated in this stage would become rotten. Applies only if the rotten_flag
is set.
order_nr
integer
An order number for this stage. Order numbers should be used to order the stages in the pipeline.
OK
/v1/stages
Marks multiple stages as deleted.
ids
string
required
The comma-separated stage IDs to delete
OK
/v1/stages/{id}
Marks a stage as deleted.
id
integer
required
The ID of the stage
OK