Connect Omnisend
This article shows you how to create an Omnisend API key, connect Omnisend to PlayerMagick, tag the people a gate collects, and start Omnisend automations with events from what people watch.
Available on: Pro, Business and Agency plans.
Before you start
- You need an Omnisend account.
- Only the PlayerMagick account owner or an admin can connect Omnisend. See Understand team roles.
Omnisend sometimes renames its menus. If a label below does not match exactly, look for the closest one.
Step 1: Create an API key in Omnisend
- Log in to Omnisend.
- Go to Store settings → API keys and click Create API key.
- Name it
PlayerMagick, give it access to Contacts, Events and Brands, and copy it.
Step 2: Connect Omnisend in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool (or Connect next to Omnisend) and choose Omnisend.
- Paste the key into API key.
- Click Test and connect.
Step 3: Tag the people a gate collects
Omnisend has no lists (segments are rules), so an Omnisend gate sends tags:
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose your Omnisend account.
- Add up to 5 Tags (at least one).
- Click Save destination.
New contacts are added as subscribed; existing contacts keep everything they have (their email status included) and get the missing tags. Omnisend's double opt-in works only for its own forms, so people added by PlayerMagick get no confirmation email. To build a segment of them, filter on the tag.
Automations from what people watch
Omnisend automations start on a custom event. In Automations, the Omnisend actions are:
- Send an event to Omnisend: keep the suggested name (for example
PlayerMagick: Watched 50%) or type your own. In Omnisend, create an automation with a custom event trigger and choose that name. It appears in Omnisend after the first event arrives. - Add tag and Remove tag. To stop an automation, add a tag its exit filter checks.
- Update a field: any custom property name (letters, digits and _), for example
pm_deadline.
Each event carries the video, the funnel step and answer, the share watched and the personal deadline as properties. It never carries an email address.
Recognise viewers from your Omnisend emails
Omnisend prints no contact ID in emails, so PlayerMagick uses its own random ID:
- PlayerMagick fills a custom property called
pm_idfor every contact it adds or updates. - In Automations → Recognise viewers from your emails, choose Omnisend and click Fill it for my existing contacts to give your other contacts an ID too.
- Add this to the end of the links (in Link and Button blocks) of your Omnisend emails:
?pm_os=[[contact.custom_properties.pm_id]]
Send yourself a test email and use Check a link. See Recognise viewers from your emails.
Good to know
- Someone who unsubscribed in Omnisend is never added again. Leads shows Not added.
- Speed: Omnisend allows 400 requests a minute per store (shared with your other apps) and only 60 tag changes a minute, so PlayerMagick changes tags at most once a second.
Error messages
| Message | What to do |
|---|---|
| "Omnisend did not accept this key. Check that you copied the whole key." | Create a new API key in Omnisend and paste it. |
| "Omnisend asked us to slow down. …" | Nothing: PlayerMagick continues when Omnisend allows. |
| "Omnisend didn't answer. Try again in a minute." | Try again in a minute. |
All statuses and fixes: Fix an email tool error.