Sales CRM webhooks | Brevo API Documentation

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

Deals webhook events

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

{
  "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

{
  "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

{
  "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

{
  "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

{
  "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

{
  "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"]
}