Connect Ontraport
This article shows you how to create an Ontraport API key, connect Ontraport to PlayerMagick, tag the people a gate collects, and start Ontraport automations from what people watch.
Available on: Pro, Business and Agency plans.
Before you start
- You need an Ontraport account whose plan includes API access.
- Only the PlayerMagick account owner or an admin can connect Ontraport. See Understand team roles.
Ontraport sometimes renames its menus. If a label below does not match exactly, look for the closest one.
Step 1: Create an API key in Ontraport
- Log in to Ontraport.
- Go to Administration → Integrations → Ontraport API Instructions and Key Manager.
- Create a new key named
PlayerMagickwith permission to view and edit contacts (and the "only own contacts" option off). - Copy the App ID and the API Key.
Step 2: Connect Ontraport in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool (or Connect next to Ontraport) and choose Ontraport.
- Paste the key into API key and the App ID into App ID.
- Click Test and connect.
Step 3: Tag the people a gate collects
Ontraport has no lists, so an Ontraport gate sends tags:
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose your Ontraport account.
- Add up to 5 Tags (at least one). Tags that don't exist yet are created.
- Click Save destination.
New contacts are created opted in to marketing email; existing contacts keep everything they have (their email status included) and get the tags. Ontraport applies tags a few seconds later. For a confirmation email, start an Ontraport automation on the tag.
Automations from what people watch
In Automations, the Ontraport actions are Add tag, Remove tag, Start campaign and Remove from campaign (Ontraport calls campaigns "automations"), and Update a field (an Ontraport custom field; dates included). For example: "When they watch 50% of the video, start the campaign Webinar follow-up".
Recognise viewers from your Ontraport emails
Ontraport's contact numbers are easy to guess, so PlayerMagick uses its own random ID:
- PlayerMagick creates a text field called
pm_id(in a "PlayerMagick" section of your contact fields) and fills it for every contact it adds or updates. - In Automations → Recognise viewers from your emails, choose Ontraport 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 your Ontraport emails:
?pm_op=[pm_id]
You can also insert the field from Ontraport's merge field picker (it appears as pm_id). Send yourself a test email and use Check a link.
Good to know
- Someone who unsubscribed (transactional only), hard bounced or is under review in Ontraport is never added again. Leads shows Not added.
- Speed: Ontraport allows 180 requests a minute; PlayerMagick sends about three a second at most.
Error messages
| Message | What to do |
|---|---|
| "Ontraport did not accept this key. Check that you copied the whole key." | Copy the API key and the App ID again, from the same key. |
| "This key can't read your lists. Use a key of a user who can manage contacts." | Give the key permission to view and edit contacts. |
| "Ontraport didn't answer. Try again in a minute." | Try again in a minute. |
All statuses and fixes: Fix an email tool error.