Create an opportunity status
Create an opportunity status and add it to the end of a pipeline’s list of statuses. If you leave out pipeline_id, the status is added to your organization’s oldest pipeline. type defaults to active and can’t be changed later.
Returns 400 if the pipeline doesn’t exist, if your organization has no pipelines, if the pipeline already has a status with the same label (ignoring case), or if the pipeline already has 250 statuses. Requires the Manage Customizations permission, otherwise returns 403.
Authentication
Bearer authentication of the form Bearer <token>, where token is your auth token.
Query parameters
Comma-separated list of fields to include in the response.
Request
Name of the opportunity status. Leading and trailing whitespace is removed. Must be unique within the pipeline (ignoring case).
ID of the pipeline to add the status to, prefixed with pipe_. Defaults to the organization’s oldest pipeline.
Whether opportunities in this status are open (active) or closed (won or lost). Can’t be changed later.
Response
Unique ID of the opportunity status, prefixed with stat_.
Name of the opportunity status, unique within its pipeline (ignoring case).
Whether opportunities in this status are open (active) or closed (won or lost).
ID of the pipeline the opportunity status belongs to, prefixed with pipe_.