Skip to main content
The OpportunityStatusUpdate event fires when an opportunity’s outcome status is changed — for example, when a deal is marked as won, lost, or abandoned. This is distinct from a stage change: status reflects the final outcome of a deal, not its position in the pipeline. Use this event to trigger post-deal workflows such as sending a win notification, logging revenue, or initiating an offboarding sequence.

​
Payload

FieldTypeDescription
typestringAlways "OpportunityStatusUpdate"
locationIdstringSub-account ID where the opportunity lives
idstringUnique identifier for the opportunity
assignedTostringUser ID of the team member assigned to this opportunity
contactIdstringID of the contact associated with this opportunity
monetaryValuenumberEstimated deal value in the sub-account’s currency
namestringDisplay name of the opportunity
pipelineIdstringID of the pipeline this opportunity belongs to
pipelineStageIdstringID of the pipeline stage the opportunity is currently in
sourcestringOrigin of the opportunity (e.g., "form", "manual", "api")
statusstringNew status of the opportunity. One of: open, won, lost, abandoned
dateAddedstringISO 8601 timestamp of when the opportunity was originally created

​
Example payload

{
  "type": "OpportunityStatusUpdate",
  "locationId": "ve9EPM428h8vShlRW1KT",
  "id": "nmFmQEsNgz6AVpgLVUJ0",
  "assignedTo": "YlWd2wuCAZQzh2cH1fVZ",
  "contactId": "CWBf1PR9LvvBkcYqiXlc",
  "monetaryValue": 40,
  "name": "Loram ipsu",
  "pipelineId": "otg8dTQqGLh3Q6iQI55w",
  "pipelineStageId": "otg8dTQqGLh3Q6iQI55w",
  "source": "form",
  "status": "won",
  "dateAdded": "2021-11-26T12:41:02.193Z"
}
Last modified on March 4, 2026