Opportunity Status Updated | Webhook Events

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

Field	Type	Description
`type`	`string`	Always `"OpportunityStatusUpdate"`
`locationId`	`string`	Account ID where the opportunity lives
`id`	`string`	Unique identifier for the opportunity
`assignedTo`	`string`	User ID of the team member assigned to this opportunity
`contactId`	`string`	ID of the contact associated with this opportunity
`monetaryValue`	`number`	Estimated deal value in the account’s currency
`name`	`string`	Display name of the opportunity
`pipelineId`	`string`	ID of the pipeline this opportunity belongs to
`pipelineStageId`	`string`	ID of the pipeline stage the opportunity is currently in
`source`	`string`	Origin of the opportunity (e.g., `"form"`, `"manual"`, `"api"`)
`status`	`string`	New status of the opportunity. One of: `open`, `won`, `lost`, `abandoned`
`dateAdded`	`string`	ISO 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"
}

Opportunity Stage Updated — fires when an opportunity moves between pipeline stages
Opportunity Updated — fires when any field on an opportunity changes
Opportunities API — query and update opportunities programmatically

​Payload

​Example payload

​Related

Payload

Example payload

Related