> ## Documentation Index
> Fetch the complete documentation index at: https://help.hoopai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Opportunity Stage Updated | Webhook Events

> Fires when an opportunity moves to a different stage within its pipeline.

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](/api-reference/webhooks/opportunity-status-update) event.

## Payload

| Field             | Type     | Description                                                               |
| ----------------- | -------- | ------------------------------------------------------------------------- |
| `type`            | `string` | Always `"OpportunityStageUpdate"`                                         |
| `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` | Current 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 new pipeline stage the opportunity was moved into               |
| `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

```json theme={null}
{
  "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"
}
```

## Related

* [Opportunity Updated](/api-reference/webhooks/opportunity-update) — fires when any field on an opportunity changes
* [Opportunity Status Updated](/api-reference/webhooks/opportunity-status-update) — fires when the win/loss outcome status changes
* [Opportunities API](/api-reference/opportunities/overview) — query and update opportunities programmatically