Events are Buttondown's way of telling you that something interesting has happened to your newsletter, and webhooks let you react to those events by sending HTTP requests to a URL of your choice. For technical details on event payloads and HMAC signing, see the API reference.
Creating webhooks
Step 1: Navigate to integrations
This is a live demo. You can view this page on your account, too.
- Log into your Buttondown account
- Go to Settings
- Click the Create webhook button:
Step 2: Configure webhook settings
This is a live demo. You can view this page on your account, too.
You'll need to provide the following information:
Webhook URL
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
Events to trigger
Select which events should trigger your webhook. Common event types include:
| Event Type | Description |
|---|---|
| subscriber.created | When someone subscribes to your newsletter |
| subscriber.confirmed | When a subscriber confirms their email |
| subscriber.unsubscribed | When someone unsubscribes |
| email.sent | When you send a newsletter |
| email.delivered | When an email is successfully delivered |
| comment.created | When someone comments on your newsletter |
You can select multiple events for a single webhook.
Step 3: Test your webhook
Once you've configured your webhook, it's recommended to test it:
- Click the Test webhook button
- Buttondown will send a test payload to your URL
- Verify that your receiving service gets the test data