Webhooks

Webhooks let you receive real-time notifications when DEXTRUM takes actions on your account.

Setting Up Webhooks

Navigate to Settings > API > Webhooks. Enter your endpoint URL and select which events you want to receive. DEXTRUM will send a POST request to your URL whenever a matching event occurs.

Supported Events

**optimization.applied** — Triggered when an optimization is successfully applied **optimization.rolled_back** — Triggered when an optimization is rolled back **guardrail.triggered** — Triggered when a guardrail halts an optimization **insight.generated** — Triggered when a new AI insight is available **account.disconnected** — Triggered if a Google Ads connection is lost

Payload Format

All webhook payloads include a timestamp, event type, and a data object with event-specific details. Payloads are signed with your webhook secret so you can verify authenticity.

Retry Policy

If your endpoint returns a non-2xx status code, DEXTRUM retries with exponential backoff up to 5 times over 24 hours. After 5 failures, the webhook is marked as unhealthy and you'll receive an email notification.