Deals

Deal deleted

deal.deleted

Fires when a deal is deleted. The deletion is a soft delete: the record, its ID, and linked conversations survive, and the deal can be restored via `POST /v1/deals/{deal}/restore`. The event still serves as the durable record of when the deletion happened. The `comments` and `custom_fields` attributes are intentionally excluded from the payload, as they may carry internal notes.

HTTP request

AISAR sends a signed POST request to your webhook_url:

http

POST {webhook_url}
Content-Type: application/json
X-AISAR-Signature: sha256=...

{
  "event": "deal.deleted",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "deal": {
      "id": 30,
      "title": "New Deal",
      "status": "open",
      "amount": "7500.00",
      "currency": "USD",
      "contact_id": 10,
      "funnel_id": 1,
      "funnel_stage_id": 5,
      "responsible_user_id": 5,
      "created_at": "2026-03-26T10:00:00.000000Z"
    }
  }
}

The X-AISAR-Signature header carries an HMAC-SHA256 signature of the request body — use it to verify the request came from AISAR.

Example payload

json

{
  "event": "deal.deleted",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T12:00:00.000000Z",
  "company_id": 1,
  "data": {
    "deal": {
      "id": 30,
      "title": "New Deal",
      "status": "open",
      "amount": "7500.00",
      "currency": "USD",
      "contact_id": 10,
      "funnel_id": 1,
      "funnel_stage_id": 5,
      "responsible_user_id": 5,
      "created_at": "2026-03-26T10:00:00.000000Z"
    }
  }
}

Payload fields

Field	Type	Description
`deal.id`	`integer`	Deal ID
`deal.title`	`string`	Deal title
`deal.status`	`string`	`open`, `won`, or `lost` — the status at the moment of deletion
`deal.amount`	`string\|null`	Deal amount as a decimal string
`deal.currency`	`string\|null`	Currency code (e.g. `USD`)
`deal.contact_id`	`integer\|null`	Associated contact ID
`deal.funnel_id`	`integer\|null`	Funnel ID
`deal.funnel_stage_id`	`integer\|null`	Funnel stage ID at the moment of deletion
`deal.responsible_user_id`	`integer\|null`	Assigned (responsible) user ID
`deal.created_at`	`string`	ISO 8601 creation timestamp