> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.brevo.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.brevo.com/_mcp/server.

This page lists the currently supported Sales webhook events and their payloads.

**Deals webhook events**

* [Task completed](/docs/sales-crm-webhooks#task-completed)
* [Task created](/docs/sales-crm-webhooks#task-created)
* [Deal stage updated](/docs/sales-crm-webhooks#deal-stage-updated)
* [Deal created](/docs/sales-crm-webhooks#deal-created)
* [Deal attributes updated](/docs/sales-crm-webhooks#deal-attributes-updated)
* [Deal association updated](/docs/sales-crm-webhooks#deal-association-updated)

## Deals webhook events

## Task completed

| Attribute name    | Datatype | Description          |
| :---------------- | :------- | :------------------- |
| `completion_date` | String   | Task completion date |
| `due_date`        | String   | Due date of task     |
| `name`            | String   | Name of the task     |
| `taskType`        | String   | Type of task         |
| `taskTypeId`      | String   | Task type ID         |
| `task_id`         | String   | Task ID              |

```json
{
  "completion_date": "2025-06-10T07:09:01.696Z",
  "due_date": "2025-06-10T07:09:01.696Z",
  "name": "Reportingtask",
  "taskType": "Reporting",
  "taskTypeId": "5f000878-0070-4b1c-8931-2c8004cf00da",
  "task_id": "844xx18c-f4ec-480e-xxde-9df8xxa3xxde"
}
```

## Task created

| Attribute name | Datatype | Description                                                  |
| :------------- | :------- | :----------------------------------------------------------- |
| `assign_to`    | String   | Indicates who the task is assigned to                        |
| `due_date`     | String   | Due date of the task                                         |
| `name`         | String   | Name of the task                                             |
| `priority`     | Bool     | Indicates if task is priority or not; True for priority task |
| `taskType`     | String   | Task type                                                    |
| `taskTypeId`   | String   | Task type ID                                                 |

```json
{
  "assign_to": "Assignee",
  "due_date": "2025-06-10T07:09:01.696Z",
  "name": "Reportingtask",
  "priority": true,
  "taskType": "5f000878-0070-4b1c-8931-2c8004cf00da",
  "taskTypeId": "844xx18c-f4ec-480e-xxde-9df8xxa3xxde"
}
```

## Deal stage updated

| Attribute name  | Datatype | Description                 |
| :-------------- | :------- | :-------------------------- |
| `amount`        | Numeric  | Amount associated with deal |
| `deal_id`       | String   | Deal ID                     |
| `deal_name`     | String   | Deal name                   |
| `lost_reason`   | String   | Reason for loss of deal     |
| `pipeline_id`   | String   | Pipeline ID                 |
| `pipeline_name` | String   | Pipeline name               |
| `stage_id`      | String   | Stage ID                    |
| `stage_name`    | String   | Stage name                  |

```json
{
  "amount": 750,
  "deal_id": "0d000913-009f-4d86-00f9-002580002511",
  "deal_name": "Deal123",
  "lost_reason": "Budget constraint",
  "pipeline_id": "bxxd35ef-c0f0-41e8-xx8a-7f820004bd57",
  "pipeline_name": "Pipeline123",
  "stage_id": "49xx7da7-axxd-4b72-xx6a-93b1dxxxcc25",
  "stage_name": "Negotiation"
}
```

## Deal created

| Attribute name  | Datatype | Description                 |
| :-------------- | :------- | :-------------------------- |
| `amount`        | Numeric  | Amount associated with deal |
| `deal_id`       | String   | Deal ID                     |
| `deal_name`     | String   | Deal name                   |
| `lost_reason`   | String   | Reason for loss of deal     |
| `pipeline_id`   | String   | Pipeline ID                 |
| `pipeline_name` | String   | Pipeline name               |
| `stage_id`      | String   | Stage ID                    |
| `stage_name`    | String   | Stage name                  |

```json
{
  "amount": 750,
  "deal_id": "0d000913-009f-4d86-00f9-002580002511",
  "deal_name": "Deal123",
  "lost_reason": "Budget constraint",
  "pipeline_id": "bxxd35ef-c0f0-41e8-xx8a-7f820004bd57",
  "pipeline_name": "Pipeline123",
  "stage_id": "49xx7da7-axxd-4b72-xx6a-93b1dxxxcc25",
  "stage_name": "Negotiation"
}
```

## Deal attributes updated

| Attribute name  | Datatype | Description                 |
| :-------------- | :------- | :-------------------------- |
| `amount`        | Numeric  | Amount associated with deal |
| `deal_id`       | String   | Deal ID                     |
| `deal_name`     | String   | Deal name                   |
| `lost_reason`   | String   | Reason for loss of deal     |
| `pipeline_id`   | String   | Pipeline ID                 |
| `pipeline_name` | String   | Pipeline name               |
| `stage_id`      | String   | Stage ID                    |
| `stage_name`    | String   | Stage name                  |

```json
{
  "amount": 750,
  "deal_id": "0d000913-009f-4d86-00f9-002580002511",
  "deal_name": "Deal123",
  "lost_reason": "Budget constraint",
  "pipeline_id": "bxxd35ef-c0f0-41e8-xx8a-7f820004bd57",
  "pipeline_name": "Pipeline123",
  "stage_id": "49xx7da7-axxd-4b72-xx6a-93b1dxxxcc25",
  "stage_name": "Negotiation"
}
```

## Deal association updated

| Attribute name           | Datatype | Description                                              |
| :----------------------- | :------- | :------------------------------------------------------- |
| `amount`                 | Numeric  | Amount associated with deal                              |
| `deal_id`                | String   | Deal ID                                                  |
| `deal_name`              | String   | Deal name                                                |
| `lost_reason`            | String   | Reason for loss of deal                                  |
| `pipeline_id`            | String   | Pipeline ID                                              |
| `pipeline_name`          | String   | Pipeline name                                            |
| `stage_id`               | String   | Stage ID                                                 |
| `stage_name`             | String   | Stage name                                               |
| `associated_entity_type` | String   | Type of associated entity; either `contact` or `company` |
| `link_ids`               | Array    | IDs of entities linked to the deal                       |
| `unlink_ids`             | Array    | IDs of entities unlinked from the deal                   |

```json
{
  "amount": 750,
  "deal_id": "0d000913-009f-4d86-00f9-002580002511",
  "deal_name": "Deal123",
  "lost_reason": "Budget constraint",
  "pipeline_id": "bxxd35ef-c0f0-41e8-xx8a-7f820004bd57",
  "pipeline_name": "Pipeline123",
  "stage_id": "49xx7da7-axxd-4b72-xx6a-93b1dxxxcc25",
  "stage_name": "Negotiation",
  "associated_entity_type": "contact",
  "link_ids": ["3", "42"],
  "unlink_ids": ["15"]
}
```