OpportunityUpdate event fires whenever any field on an existing opportunity is changed. This is a broad event that covers edits to the opportunity name, monetary value, pipeline stage, status, assignment, and more. Use this event to keep external systems in sync or to trigger follow-up actions whenever a deal progresses.
Payload
| Field | Type | Description |
|---|---|---|
type | string | Always "OpportunityUpdate" |
locationId | string | Sub-account ID where the opportunity lives |
id | string | Unique identifier for the opportunity |
assignedTo | string | User ID of the team member currently assigned to this opportunity |
contactId | string | ID of the contact associated with this opportunity |
monetaryValue | number | Current estimated deal value in the sub-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 current pipeline stage |
source | string | Origin of the opportunity (e.g., "form", "manual", "api") |
status | string | Current status of the opportunity (open, won, lost, or abandoned) |
dateAdded | string | ISO 8601 timestamp of when the opportunity was originally created |
Example payload
Related
- Opportunity Created — fires when a new opportunity is first added to a pipeline
- Opportunity Stage Updated — fires specifically when the pipeline stage changes
- Opportunities API — query and update opportunities programmatically
.png?fit=max&auto=format&n=EQK5eX9kTD8NzWwA&q=85&s=878008bf159fcc4964d0c0d508b6e400)