Email Marketing Integrations
The Email Marketing Integrations add-on keeps a list on your email platform in step with your show. It works with Mailchimp, Kit, ActiveCampaign, MailerLite and Beehiiv. When someone follows or subscribes, they’re added to the show’s list with their first name. Each contact carries tags saying whether they follow for free or which tier they pay for, and the tags change as they move tier, cancel or come back.
A second set of tags follows whether each subscriber’s podcast app is actually using their private feed: not set up yet, set up, in use, or gone quiet. That’s the part your email platform can’t see for itself. With it, you can send setup help to someone who never added the feed, and a win-back email to someone who stopped listening, instead of mailing everyone the same thing.
The add-on is free on every Benecaster plan, Launch included. Install it like any other add-on (see Installing Add-ons), and switch it on for the shows you want under Benecaster → Settings → Add-ons → the Email Marketing Integrations card → Active on.
Setting Up
Setup has two parts: your platform and API key once for the whole site, then a list for each show.
Your Platform and API Key
Go to Benecaster → Settings → Email Marketing. Under Your Email Platform:
- Choose your platform from Platform.
- Paste your key into API key. A hint under the box says where your platform keeps it. On ActiveCampaign, also fill in API URL, which appears only for ActiveCampaign.
- Click Save Settings.
One platform and one key serve all your shows. Once a key is saved, Test Connection checks it with your platform and Remove Key deletes it. The line under the key says where things stand:
- An API key is saved, and your platform accepted it.
- An API key is saved, but your platform could not be reached to check it. Use Test Connection.
- Benecaster can no longer read the saved API key. Enter it again.
- No API key is saved.
Choosing a different platform warns you before you save: Saving a different platform removes the saved API key and every show’s chosen list. Contacts already on your old platform stay there, and the new platform’s lists start empty. Each show’s contact field choices are cleared too.
The page’s Shows section lists every show the add-on is switched on for, with the name of its list (as the show’s tab shows it), or No list chosen until it has one, and a Show Settings → button that opens that show’s tab. The page stays available even when the add-on is switched off on every show, so you can always reach the removal settings below.
Each Show’s List
Open Show Settings → Email Marketing for the show. The tab appears on shows the add-on is switched on for.
The list. The first section is named for what your platform calls a list: Mailchimp Audience, Kit Tag, ActiveCampaign List, MailerLite Group or Beehiiv Publication. Click Choose a List, pick one, and click Save Settings at the bottom of the tab. Until a show has a list, nothing is sent for it.
A list starts empty. Only people who join the show after you choose it are added. Subscribers the show already has and members added by Sync Existing Members are not added, whatever Who Joins the List says. To bring them over, use your email platform’s own import. People you add with Bulk Enroll Subscribers are new to the show, so they join as Who Joins the List says.
Contact Fields chooses where each contact’s first name and tier go. The line under the heading shows the current choice, such as First name: First Name. Tier: Not sent. Click Change Fields to load your platform’s text fields into two drop-downs:
- First name field starts on your platform’s own name field. Pick another text field, or Don’t send first names.
- Tier field starts on Don’t send the tier (tag only). Pick a text field and it holds the name of the tier each subscriber is on, such as Gold. It changes when they move tier and is emptied when their tier ends. Followers have no tier, so it stays empty for them. The tier tag goes on either way.
Only text fields that already exist on your platform are listed, so create the field there first. The first name and the tier can’t share a field, including when First name field is left on your platform’s own name field: Save Settings refuses it with The first name and the tier cannot go to the same field. Choose a different field for one of them. With Don’t send first names, that field is free for the tier. On Mailchimp and Beehiiv, fields belong to the list, so choose the list first; choosing another list clears both field choices.
Who Joins the List decides who is added:
| Option | Who joins |
|---|---|
| Opt-in: only people who tick the box to get your emails | Only people who tick the box. This is where every show starts. |
| Opt-out: every new signup joins, unless they have told Benecaster no | Everyone who signs up, except someone who has said no. |
| Always: every new signup joins | Everyone who signs up. |
On an opt-in show with a list, Benecaster’s own signup and checkout forms show an unticked box reading Email me about new episodes and offers from {show}. Paid subscribers who tick it join straight away, and so do donors who tick the mailing-list box on your donation form. Followers and free-tier signups join once their answer is confirmed: straight away if they were logged in, otherwise when they click the button that says yes to your emails. For a follower, that’s Confirm and follow, and yes to: in the follower confirmation email; Confirm and follow alone doesn’t add them. For a free-tier signup, it’s the Yes to: button in their Welcome email. The follower confirmation email goes out only while Ask new followers to confirm their email is on under Show Settings → Subscription, so with it off, followers who aren’t logged in never join. The tab says which applies to your show and links to Subscription settings →. Marketing Consent has the detail on confirmed answers.
On opt-out and always shows, no box is shown. Choosing either means adding people who didn’t tick anything, so check your own lawful basis for doing that first; see Privacy and Data Handling.
A show run through a membership plugin offers only opt-out and always, and starts on opt-out, because Benecaster can’t add a box to that plugin’s checkout. A show saved as opt-in that later moves to a membership plugin adds nobody until you choose opt-out or always, and the tab says so.
Cancellations and Unsubscribes has two boxes, both off until you tick them:
- Remove someone from the list when they cancel their subscription (otherwise they stay on it, without their tier tag)
- When someone unsubscribes from this show’s Benecaster emails, unsubscribe them on {platform} too
See Cancellations and Unsubscribes below for exactly what each does.
Tag Names and Engagement Tags list every tag the add-on uses, with its default name shown in the box. Type a name to use your own instead, or leave the box empty to keep the default. Below them, the tab shows the show’s Feed inactivity threshold: N days. with a link to change it.
The Tags
| Box on the tab | Default name | On the contact while |
|---|---|---|
| Tier: {tier name}, one per tier | benecaster_tier_{tier slug} |
They subscribe on that tier |
| Follower (free, not paying) | benecaster_follower |
They follow for free |
| Cancelled their subscription | benecaster_cancelled |
Their subscription ended because they cancelled or stopped paying, until they come back |
| Moved to a higher tier | benecaster_tier_upgraded |
Their last tier move was up |
| Moved to a lower tier | benecaster_tier_downgraded |
Their last tier move was down |
| Feed not set up yet, a week after signing up | benecaster_feed_not_setup |
Their podcast app hasn’t used their feed in the week after they signed up |
| Feed set up for the first time (added once, never removed) | benecaster_feed_setup_complete |
Always, once their app first uses the feed |
| Feed set up and in use | benecaster_feed_active |
Their app is using the feed |
| Feed gone quiet | benecaster_at_risk |
Their app hasn’t used the feed within the show’s Feed inactivity threshold (days) |
Benecaster’s public tier gets no tier tag. A contact never carries the upgraded and downgraded tags together.
On Kit, the add-on creates a tag the first time it needs to look it up, so your Kit account can show a Benecaster tag with no subscribers before anyone has been given it.
What Happens When
Every update below reaches your platform in the background, usually within about five minutes. Tags and fields change only for someone the add-on itself added to the list, so contacts you brought in some other way are left alone. Removal is the one exception: it reaches every show’s list, whoever added the person. Someone who unsubscribed on your platform is never subscribed again by Benecaster.
Someone Signs Up
A new subscriber or follower is added to the show’s list if its Who Joins the List option lets them in, with their first name and their tier or follower tag (and the tier’s name, if the show has a tier field). A donor who ticks the box joins without a feed, with no tier tag.
If someone says no to your emails after joining, they’re unsubscribed on your platform, and a later yes doesn’t subscribe them again. Their contact and tags stay.
Tier Changes
A subscriber who moves tier, however it happens, loses their old tier tag and gets the new one. A move up adds the upgraded tag and takes off the downgraded one; a move down does the reverse. Benecaster ranks a show’s tiers in the order they’re listed, lowest first. A pair it can’t rank gets neither tag. A tier move never adds anyone to the list.
A Follower Starts Paying
Their follower tag comes off and their tier tag goes on, under the show’s Who Joins the List option.
Cancellations
When someone’s subscription ends, they stay on the list and lose their tier (or follower) tag. The cancelled tag goes on only when the subscription itself ended: they cancelled, or they stopped paying. When you revoke them, a manual grant ends or a promotion’s grace period runs out, only the tag comes off.
A subscriber whose membership ends while they keep episodes they bought loses the tier tag, gets no cancelled tag, and stays subscribed.
With Remove someone from the list when they cancel their subscription ticked, someone who cancels their own subscription is removed from the list instead, using the platform’s ordinary delete: Mailchimp archives them, and Kit unsubscribes them and takes off the list and tier tags. Nobody who loses access for another reason is removed. If they come back, they’re added as a new contact.
License Lapses
If your Benecaster license lapses long enough that private feeds stop (see License Status), your contacts lose their tier and follower tags, even though the show reads as switched off. When the license recovers, the tags come back and any cancelled tag comes off. Only tags change: no email is sent.
Returning Subscribers
When someone’s feed is active again, because they resubscribed or you used Reset Token on Benecaster → Subscribers, they’re added back under the show’s Who Joins the List option. The cancelled tag and any old tier or follower tag come off, and the current one goes on. Reset Token clears the cancelled tag whatever the reason the feed was switched off.
Address Changes
When someone on a list changes their email address, through a confirmed change on their Benecaster account page or an admin edit under Users, their contact moves to the new address on every show that added them, keeping its status, list and tags. Mailchimp, Kit, ActiveCampaign and Beehiiv change the address on the existing contact.
MailerLite can’t change an address through its API, so the add-on creates a contact at the new address with the old one’s status, name and groups, then deletes the original. Someone unsubscribed stays unsubscribed.
If your platform refuses the change because another contact already has that address, the Email Marketing Sync Failed notice says so, and the contact keeps the old address.
Unsubscribes
With When someone unsubscribes from this show’s Benecaster emails, unsubscribe them on {platform} too ticked, a broadcast opt-out or a full opt-out from the show (see Email Unsubscribe) also unsubscribes them on your platform. Their tags stay. Opting out of new-episode emails alone doesn’t, and neither does any opt-out with the box unticked. Opting back in never subscribes them on your platform again.
An unsubscribe made from an email link without logging in can’t be matched to a contact, so it stays on Benecaster’s side.
Removing Someone
A person is removed from every show’s list on your platform when:
- their WordPress account is deleted;
- you use Delete Subscriber Data under Settings → GDPR / Privacy;
- you complete their request under Tools → Erase Personal Data;
- Benecaster’s data retention deletes them, but only with Also remove a contact from your email platform when Benecaster’s data retention deletes the subscriber ticked under Settings → Email Marketing → Removing Data. It’s off until you tick it.
This uses the strongest removal each platform offers, and it runs even on a show the add-on is switched off for. Privacy and Data Handling says what removal means on each platform.
A Show Is Deleted
When a show is permanently deleted from the Trash, the add-on forgets its list choice, its other settings, its record of who it added and any updates waiting to be sent. The show’s contacts stay on your platform, and nothing is sent. Moving a show to the Trash changes nothing.
Engagement Tags
The engagement tags follow each subscriber’s private feed:
- Not set up. If a subscriber’s podcast app hasn’t used their feed a week after they signed up, they get the not-set-up tag.
- Set up. The first time their app uses the feed, the not-set-up tag comes off and they get both the set-up-for-the-first-time tag and the in-use tag. The first-time tag stays for good, so an onboarding automation keyed to it runs once.
- Gone quiet. If the app then goes longer than the show’s Feed inactivity threshold (days) without using the feed (set under Show Settings → Subscription), the in-use tag comes off and the gone-quiet tag goes on.
- Back. When the app uses the feed again, the gone-quiet tag comes off and the in-use tag goes back on.
These update only for someone the add-on already added to the list. While the add-on is switched off for a show, they aren’t updated, and switching it back on doesn’t catch up, so a contact’s engagement tags can stay out of date until their feed next changes.
Platform Notes
| Platform | Where the key is | The show’s list is |
|---|---|---|
| Mailchimp | Your profile icon → Profile → Extras → API keys | An audience |
| Kit | Settings → Developer. Use a v4 API key | A Kit tag |
| ActiveCampaign | Settings → Developer, which shows the API URL and the key | A list |
| MailerLite | Integrations → MailerLite API | A group |
| Beehiiv | Settings → API, under Workspace Settings | A publication |
Mailchimp. A contact erased through Benecaster can never be added back through Mailchimp’s API, so if they sign up again, the add-on can’t add them to your audience.
Kit. Kit has no lists, so each show uses a Kit tag as its list. Kit can’t delete a subscriber through its API: removing someone unsubscribes them and takes off the show’s tag and the add-on’s tags, and the record stays in Kit until you delete it there.
ActiveCampaign. Fill in both the API URL and the key. A deleted contact stays in ActiveCampaign’s contact archive for 360 days.
MailerLite. Only the current MailerLite works. MailerLite Classic accounts aren’t supported. MailerLite has no tags, so each tag is a group of that name, created the first time it’s used. Those groups appear beside your show’s own group and count toward MailerLite’s limit of 1,000 groups.
Beehiiv. A workspace Owner or Admin creates the key, and Beehiiv may ask you to complete its identity check first. Beehiiv has no name field of its own, so first names are sent only if you choose one of the publication’s custom fields under Contact Fields. A publication holds at most 100 distinct tags. Benecaster sends no Beehiiv welcome email, but the publication’s own double opt-in setting still applies. Beehiiv limits how many requests a key can make each minute (30 on its free plan), so a busy day’s updates can take longer to arrive.
Setup Reminders
Until the add-on is set up, the Dashboard’s Needs Attention section shows one reminder at a time, each linking to Settings → Email Marketing:
- Select your email platform. with Open Settings →
- Connect your API key. with Add API Key →. This stays until your platform has accepted the key.
- Select a subscriber list. with Choose List →, until at least one show the add-on is on for has a list.
The Tour
The Email Marketing Integrations Tour shows you the Platform drop-down on Settings → Email Marketing (including where ActiveCampaign shows its API URL), then Tag Names and Engagement Tags on the current show’s Email Marketing tab. Open it from the Tours catalog (the Tours link in the Benecaster admin footer). It’s listed while the add-on is switched on for at least one show. See Getting to Know Benecaster — Tours.
When an Update Fails
If your platform doesn’t answer or is busy, the update is tried again over about nine hours. If your platform refuses it outright, such as a rejected key or a list that no longer exists, it isn’t retried. Either way, a failed update brings up Email Marketing Sync Failed in the Benecaster Notifications bell. It says how many updates couldn’t be sent, names each show with the reason, and links to Open Email Marketing Settings. Failed updates are cleared after 30 days.
Switching Off, Staging Sites and Uninstalling
Switched off for a show. Nothing is sent for the show, and updates already waiting are held until you switch it back on. What happens while it’s off isn’t replayed later: people who sign up then aren’t added, and address changes and engagement tags aren’t sent. License lapses and removals are the exception: they still reach your platform.
On a staging site or other copy of your site, the add-on sends nothing to your platform, removals included, and updates copied over with the database are never sent from the copy. Settings → Email Marketing shows this warning at the top:
This site looks like a copy of your live site, such as a staging site, so Email Marketing Integrations sends nothing to your email platform from it: no new contacts, no tags and no removals. Updates are held here and never reach your list. If this is your live site, add define( ‘BENECASTER_IS_PRODUCTION’, true ); to wp-config.php.
See Testing with a Staging Site.
Deactivating the add-on on the Plugins screen deletes nothing, but while it’s deactivated no removal or erasure reaches your platform. Remove the person there by hand.
Deleting the add-on from Plugins deletes the saved API key only if Delete the saved API key when this add-on is deleted from Plugins is ticked under Settings → Email Marketing → Removing Data. It’s off until you tick it. Nothing else is deleted: your settings, the add-on’s records and any waiting updates stay on your site, and your contacts stay on your platform.
See Also
Need this built rather than just documented? See our services →
Last updated