Skip to main content
The OpportunityStageUpdate event fires whenever an opportunity is moved from one pipeline stage to another. This is useful for tracking deal progression, triggering stage-specific automations, or updating the pipeline view in connected tools. For changes to the opportunity’s overall outcome, see the Opportunity Status Updated event.

​
Payload

FieldTypeDescription
typestringAlways "OpportunityStageUpdate"
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
monetaryValuenumberCurrent estimated deal value in the sub-account’s currency
namestringDisplay name of the opportunity
pipelineIdstringID of the pipeline this opportunity belongs to
pipelineStageIdstringID of the new pipeline stage the opportunity was moved into
sourcestringOrigin of the opportunity (e.g., "form", "manual", "api")
statusstringCurrent status of the opportunity (open, won, lost, or abandoned)
dateAddedstringISO 8601 timestamp of when the opportunity was originally created

​
Example payload

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