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. writeAuth methods:
OAuthPrivate IntegrationToken type:
Sub-Account TokenRequest
Headers
Versionstringrequired
API Version. Send v3.
Available options
v3Example:
v3Path Parameters
idstringrequired
Opportunity Id
Example:
yWQobCRIhRguQtD2llvkBody
statusstringrequired
New status for the opportunity
Available options
openwonlostabandonedExample:
openlostReasonIdstring
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:
65f1c2a4e8b9d3f7a2c4e6b8Response
Successful response
successbooleanrequired
Indicates whether the operation was successful
Example:
true