Perhaps you’re integrating with Buttondown’s API, or using webhooks for custom workflows—either way, you might need events data to tie everything together.
How to export email event data
- Start in the events log
- Select the event (or events) that you’d like to export
- Click “Export” in the upper right hand corner
If you want to export all events, simply click the “Export” button. No need to select all!
Here's what this process looks like:
When your export’s completed, a .csv file will automatically download.
If the process is taking longer than expected, we'll send you an email with the export attached.
How to export the analytics for a single email
If you only want the aggregate analytics for one email, open that email’s analytics page and click the export icon in the “Analytics” section header. Buttondown will immediately download a CSV that summarizes that email’s totals—recipients, deliveries, opens, clicks, unsubscriptions, and so on—one metric per row.
This is the same data the analytics API serves, so if you'd rather pull it programmatically, you can!
What's included in the export
This includes your event ID, type, timestamp, and more.
Here is a complete list of all the data fields included:
| Key | Sample Value |
|---|---|
| id | 007b00gg-7c27-2bg7-853a-4f3fr3e09c7e |
| subscriber__email | liz.lemon@tgs-nbc.com |
| event_type | subscriber.opened |
| creation_date | 2024-03-13 00:16:58+00:00 |
| metadata | {'country': '', 'client_os': 'Windows', 'client_name': 'Gmail', 'client_type': 'Desktop'} |