Export your audience

Export your audience data for use in external tools, analytics platforms, or backups — no need to rebuild your list by hand when you want to work with it elsewhere.

Tip

Curious what Penpal can help with? See how Penpal works.

Export all contacts or a segment

From the Audience view you can export your whole list, or narrow the export to a custom segment first. Select the segment, then use the Export option.

The built-in Smart Engagement-Based Segments — Active Openers, Active Clickers, and Inactive Subscribers — aren’t currently available as an export scope. If you need that data, export your whole list and filter it afterward in a spreadsheet or analytics tool.

How long an export takes

Exports are built in the background and the file is emailed to you when it’s ready, so a big list can take a while. When you start an export, the confirmation tells you roughly how long the file will take to reach your inbox, sized to how many contacts your filters match — for example “usually ready in about 1 to 2 hours”. It’s a range, not a promise.

If you start an export through the API or ask Penpal to start one, you get the same estimate. While it runs, checking on the export shows how far along it is and an updated estimate based on how quickly it has actually been moving, until the file is ready and you get a download link.

Export your engagement events

The contacts export tells you who is on your list. To see what those contacts actually did, export your engagement events instead: one row for every delivery, open, click, bounce or unsubscribe your newsletters recorded in the days you choose.

From the Audience view’s Contacts table, next to Export audience, choose Export engagement events, then:

1. Pick the First day and Last day. The window can cover up to 31 days, both days are included, and days are read in UTC.
2. Under Include, choose which kinds of event you want: Delivered, Opened, Clicked, Bounced and Unsubscribed.
3. Submit the form. We email you a link to the CSV when it’s ready, and the link expires after 7 days.

Company administrators can also ask Penpal to start the export for a date window. Penpal gives you the link when the export is ready, rather than emailing it.

Each row holds the contact’s email address, what happened (sent, opened, clicked, bounced or unsubscribed), when it happened (in UTC), the newsletter’s subject and ID, and the link for a click. Nothing else about the event is included.

Because both files list contacts by email address, you can line the two up in a spreadsheet. For example, find each contact’s most recent open in your events export and check it against the segment they landed in.

A window with no matching events gives you a file with only the header row.

Related

• Import subscribers — bring contacts back in, or into another account.
• Working in Audience