Webhook Configuration

Webhooks let Castor Flow notify your other systems in real time when something happens — a new lead is added, a deal moves to a new stage, or an interaction is logged.

Creating a webhook

1. Go to Settings → Webhooks
2. Click "Add Webhook"
3. Enter the URL that should receive the POST request
4. Select which events should trigger the webhook
5. Click Save

Available events

• business.created — a new business is added
• business.stage_changed — a pipeline stage is updated
• interaction.created — a new interaction is logged
• sync.completed — a Gmail or Outlook sync run finishes

Payload format

All webhook payloads are JSON with a consistent envelope:

{
  "event": "business.created",
  "timestamp": "2026-03-06T10:00:00Z",
  "data": { ... }
}

Retries

If your endpoint returns a non-2xx status, Castor Flow retries the webhook up to 3 times with exponential backoff (1 min, 5 min, 30 min).