> ## 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 Status Updated | Webhook Events

> Fires when an opportunity's win/loss status changes.

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

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

## Related

* [Opportunity Stage Updated](/api-reference/webhooks/opportunity-stage-update) — fires when an opportunity moves between pipeline stages
* [Opportunity Updated](/api-reference/webhooks/opportunity-update) — fires when any field on an opportunity changes
* [Opportunities API](/api-reference/opportunities/overview) — query and update opportunities programmatically