Webhooks

Receive real-time notifications when events happen in your newsletter.

What Are Webhooks?

Webhooks are automated messages sent to your server when specific events occur. They let you:

• Sync subscribers to external systems
• Trigger actions in other tools
• Build custom integrations
• Track events in real-time

Creating a Webhook

1. Go to Settings → Webhooks
2. Click "Add Webhook"
3. Enter your endpoint URL
4. Select events to subscribe to
5. Click "Create Webhook"

Available Events

Webhook Payload

Each webhook sends a JSON payload:

{
  "event": "subscriber.created",
  "timestamp": "2025-01-10T14:30:00Z",
  "newsletter_id": "nl_abc123",
  "data": {
    "email": "[email protected]",
    "name": "John Doe",
    "subscribed_at": "2025-01-10T14:30:00Z"
  }
}

Webhook Security

Verify webhooks are from DailyDraft:

Signature Verification

Each webhook includes an X-DailyDraft-Signature header. Verify it using your webhook secret.

IP Allowlist

Optionally restrict your endpoint to accept requests only from DailyDraft IPs.

Testing Webhooks

1. Go to your webhook settings
2. Click "Send Test"
3. A sample payload is sent to your endpoint
4. Verify it was received correctly

Webhook Logs

View delivery logs for each webhook:

• Timestamp of each delivery attempt
• HTTP response code
• Response body (first 1KB)
• Retry attempts if failed

Retry Policy

Failed webhooks are retried:

• 3 retry attempts
• Exponential backoff (1 min, 5 min, 30 min)
• After all retries fail, webhook is marked as failed