Webhooks

Webhooks let you receive real-time HTTP notifications when events occur in your DesignAdvertise workspace. Use webhooks to trigger workflows in external systems, keep dashboards up to date, or build custom alerting.

Setting up webhooks

• Navigate to Settings → API → Webhooks
• Click 'Add Endpoint' and enter your HTTPS URL
• Select the events you want to subscribe to
• Click 'Create' — DesignAdvertise sends a verification request to your endpoint
• Your endpoint must respond with 200 OK to confirm

Available events

campaign.created        — A new campaign was created
campaign.launched       — A campaign went live
campaign.paused         — A campaign was paused
campaign.completed      — A campaign reached its end date
campaign.budget_alert   — Campaign spend hit a threshold

creative.generated      — New creative was generated
creative.approved       — Creative was approved for use
creative.rejected       — Creative failed governance checks

connection.synced       — Platform data sync completed
connection.error        — A connection encountered an error

report.ready            — A scheduled report is available

Payload format

{
  "id": "evt_abc123",
  "type": "campaign.launched",
  "created_at": "2026-03-15T14:30:00Z",
  "data": {
    "campaign_id": "camp_xyz789",
    "name": "Spring Collection Launch",
    "channels": ["google_ads", "meta_ads"],
    "budget": 5000
  }
}

Security

Every webhook request includes a signature in the X-DA-Signature header. Verify this signature using your webhook signing secret (available in Settings → API → Webhooks) to ensure requests are genuinely from DesignAdvertise. Unverified requests should be rejected.

Retry policy

If your endpoint doesn't respond with a 2xx status within 10 seconds, DesignAdvertise retries the delivery. Retries use exponential backoff: 1 minute, 5 minutes, 30 minutes, 2 hours, 24 hours. After 5 failed attempts, the endpoint is disabled and you're notified via email.