Funnels

Funnel stage updated

funnel.stage.updated

Fires when a funnel stage is modified — for example, renamed or reordered. The payload carries the stage state after the update.

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": "funnel.stage.updated",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T10:00:00.000000Z",
  "company_id": 1,
  "data": {
    "funnel": {
      "id": 3,
      "name": "Sales Pipeline"
    },
    "stage": {
      "id": 12,
      "name": "Closing",
      "order": 3,
      "funnel_id": 3
    }
  }
}

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": "funnel.stage.updated",
  "event_id": "evt_01JXXXXXXXXXXXXXXXXXXXXX",
  "timestamp": "2026-03-26T10:00:00.000000Z",
  "company_id": 1,
  "data": {
    "funnel": {
      "id": 3,
      "name": "Sales Pipeline"
    },
    "stage": {
      "id": 12,
      "name": "Closing",
      "order": 3,
      "funnel_id": 3
    }
  }
}

Payload fields

Field	Type	Description
`funnel.id`	`integer`	Funnel ID
`funnel.name`	`string`	Funnel name
`stage.id`	`integer`	Stage ID
`stage.name`	`string`	Stage name
`stage.order`	`integer`	Stage order position within the funnel
`stage.funnel_id`	`integer`	ID of the parent funnel