Creating webhooks in the dashboard

Webhooks allow you to automatically send data from Buttondown to other applications when specific events occur in your newsletter. This guide walks you through creating webhooks using the Buttondown dashboard.

1. Log into your Buttondown account
2. Go to Settings
3. Click the Create webhook button:

You'll need to provide the following information:

Enter the URL where Buttondown should send event data. This URL is typically provided by:

• Third-party services (Discord, Slack, etc.)
• Automation platforms (Zapier, Make, n8n)
• Your own application endpoint

Select which events should trigger your webhook. Common event types include:

You can select multiple events for a single webhook.

Once you've configured your webhook, it's recommended to test it:

1. Click the Test webhook button
2. Buttondown will send a test payload to your URL
3. Verify that your receiving service gets the test data

Buttondown sends webhook data in JSON format. Here's an example payload:

{
  "event_type": "subscriber.created",
  "data": {
    "subscriber": {
      "id": "ac79483b-cd28-49c1-982e-8a88e846d7e7",
      "email": "example@email.com",
      "created_at": "2024-01-15T10:30:00Z",
      "metadata": {},
      "tags": ["newsletter"]
    }
  },
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "timestamp": "2024-01-15T10:30:00Z"
}

• Events and webhooks introduction
• Webhook event types
• API webhook endpoints