Connect EmailOctopus
This article shows you how to create an EmailOctopus API key, connect EmailOctopus to PlayerMagick, add the emails a gate collects to a list with tags, and start EmailOctopus automations from what people watch.
Available on: Pro, Business and Agency plans.
Before you start
- You need an EmailOctopus account with at least one list.
- Only the PlayerMagick account owner or an admin can connect EmailOctopus. See Understand team roles.
EmailOctopus sometimes renames its menus. If a label below does not match exactly, look for the closest one.
Step 1: Create an API key in EmailOctopus
- Log in to EmailOctopus.
- Go to Integrations & API → API.
- Create a key, name it
PlayerMagickand copy it. A key made before EmailOctopus's API version 2 does not work: create a new one.
Step 2: Connect EmailOctopus in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool and choose EmailOctopus.
- Paste the key into API key.
- Click Test and connect.
The card names the account after your oldest list.
Step 3: Choose a list and tags for a gate
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose EmailOctopus and a List.
- Add up to 5 Tags if you like.
- Click Save destination.
- Confirmation emails: EmailOctopus uses the list's own double opt-in setting. On a list with double opt-in, new people wait as "pending" until they confirm.
- In EmailOctopus each list keeps its own contacts and tags: the same person on two lists is two contacts.
Start EmailOctopus automations from what people watch
- In EmailOctopus, create an automation with the trigger Started via API.
- In PlayerMagick, in Automations, add the action Start automation and choose it.
A contact goes through an automation once, unless the automation allows contacts to repeat. EmailOctopus has no way for other apps to stop an automation: make it check a tag, and add that tag with Add tag.
Other actions for EmailOctopus: Add tag, Remove tag and Update a field (a field of the contact's list; date fields take dates like 2026-10-28).
Recognise viewers from your EmailOctopus emails
Add this to the end of the links in your EmailOctopus emails:
?pm_eo={{ID}}
Send yourself a real email (merge tags are not filled in test emails) and use Check a link.
Good to know
- Someone who unsubscribed from the list is never added to it again. Leads shows Not added.
- Speed: EmailOctopus allows 10 requests a second; leads usually arrive within seconds.
Error messages
| Message | What to do |
|---|---|
| "EmailOctopus did not accept this key. Check that you copied the whole key." | Copy the key again, or create a new key if yours is older than API version 2. |
| "This key can’t read your lists. Use a key of a user who can manage contacts." | Create a list in EmailOctopus first, then try again. |
| "EmailOctopus didn’t answer. Try again in a minute." | Try again in a minute. |
All statuses and fixes: Fix an email tool error.