Skip to main content
OpportunitiesVersion: v3New

Update Opportunity Status

PUT/opportunities/{id}/status

Update Opportunity Status

Authorizations

Authorizationstringheaderrequired

Bearer authentication header of the form Bearer <token>, where <token> is your access token.

Scope:opportunities.write
Auth methods:OAuthPrivate Integration
Token type:Sub-Account Token

Request​

Headers

Versionstringrequired

API Version. Send v3.

Available optionsv3
Example:v3

Path Parameters

idstringrequired

Opportunity Id

Example:yWQobCRIhRguQtD2llvk

Body

statusstringrequired

New status for the opportunity

Available optionsopenwonlostabandoned
Example:open
lostReasonIdstring

Lost reason id (24-character hex) from GET /opportunities/lost-reason. Used only when the opportunity's status is, or is set to, lost; any other status clears the stored lost reason, and null clears it too. A malformed id returns 400 LOST_REASON_NOT_FOUND; an id that is unknown, deleted or from another location is saved as null.

Example:65f1c2a4e8b9d3f7a2c4e6b8

Response

Successful response

successbooleanrequired

Indicates whether the operation was successful

Example:true