Connect Keap
This article shows you how to create a Keap Service Account Key, connect Keap to PlayerMagick, tag the people a gate collects, and start campaign sequences and API goals from what people watch.
Available on: Pro, Business and Agency plans.
Before you start
- You need a Keap account and admin rights in it (to create a Service Account Key).
- Only the PlayerMagick account owner or an admin can connect Keap. See Understand team roles.
Keap sometimes renames its menus. If a label below does not match exactly, look for the closest one.
Step 1: Create a Service Account Key in Keap
- Log in to Keap as an admin.
- Go to Settings → API (in some accounts: Admin → Settings → Application → API Settings).
- Create a Service Account Key, name it
PlayerMagick, and copy it. Keap shows it only once.
Step 2: Connect Keap in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool (or Connect next to Keap) and choose Keap.
- Paste the key into Service account key.
- Click Test and connect.
Step 3: Tag the people a gate collects
Keap has no lists, so a Keap gate sends tags:
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose your Keap account.
- Add up to 5 Tags (at least one). Tags that don't exist yet are created.
- Click Save destination.
- New contacts are created with the email address and marked as opted in ("Signed up through a PlayerMagick video"), so Keap can email them.
- Existing contacts keep everything they have (their email status included) and get the tags. PlayerMagick never creates a second contact for the same address.
- Keap has no confirmation email through its API. To send one, start a campaign on the tag.
Sequences and goals from what people watch
In Automations, the Keap actions are:
- Add tag and Remove tag.
- Start campaign sequence and Remove from campaign sequence: choose a sequence of one of your campaigns.
- Update a field: a Keap custom field (dates included).
- Send an event to Keap: Keap receives it as an API goal. Keep the suggested name (for example
PlayerMagick_Watched_50) or type your own (letters, digits, - and _). In your Keap campaign, add an API goal with the integration nameplayermagickand that call name.
Recognise viewers from your Keap emails
Keap's contact numbers are easy to guess, so PlayerMagick uses its own random ID:
- PlayerMagick creates a custom field called
pm_idand fills it for every contact it adds or updates. - In Automations → Recognise viewers from your emails, choose Keap 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 Keap emails:
?pm_kp=~Contact._pm_id~
In Keap's email builder you can also insert the field from the merge field list (Contact → custom fields → pm_id): use whatever Keap inserts after ?pm_kp=. Send yourself a test email and use Check a link.
Good to know
- Someone who opted out, bounced or was marked as spam in Keap is never added again. Leads shows Not added.
- Automations and recognition only use contacts Keap may email (single or double opt-in, confirmed, or unengaged but still marketable). A contact who never opted in is not recognised from a link and gets no automation actions; a gate still adds its tags.
- Update a field keeps every other custom field of the contact as it is. Keap has no way to change one field alone, so a change you make in Keap at the very same moment can be overwritten.
- Speed: Keap allows 240 requests a minute for a key; PlayerMagick sends about four a second at most.
Error messages
| Message | What to do |
|---|---|
| "Keap did not accept this key. Check that you copied the whole key." | Create a new Service Account Key and paste it. |
| "This key can't read your lists. Use a key of a user who can manage contacts." | Create the key as a Keap admin. |
| "Keap didn't answer. Try again in a minute." | Try again in a minute. |
All statuses and fixes: Fix an email tool error.