Connect Kit
This article shows you how to create a Kit API key, connect Kit to PlayerMagick, and send the emails a gate collects to a Kit form, tags, or both.
Available on: Pro, Business and Agency plans.
Before you start
- You need a Kit account and permission to create API keys in it.
- Only the PlayerMagick account owner or an admin can connect Kit. See Understand team roles.
- PlayerMagick uses Kit's current API keys, called v4. The older v3 "API Key" and "API Secret" do not work.
Kit sometimes renames its menus. If a label below does not match exactly, look for the closest one.
Step 1: Create an API key in Kit
- Log in to Kit.
- Go to Settings → Developer.
- Under the v4 API keys, click Add a new key.
- Name it
PlayerMagick, so you recognise it later. - Copy the key. Keep the page open until PlayerMagick has saved it.
Do not copy the v3 API Key or API Secret that may also show on that page.
Step 2: Connect Kit in PlayerMagick
- Go to Settings → Integrations.
- Click Connect an email tool (or Connect next to Kit) and choose Kit.
- Paste the key into API key (v4).
- Click Test and connect.
PlayerMagick checks the key with Kit and reads one of your forms before saving it. The card then shows "Kit · " and your Kit account's name, with "Connected".
Step 3: Choose a form and tags for a gate
- Open your video, click the Interactions tab and click the email gate.
- Under Send leads to, choose your Kit account in Email tool.
- In Form, choose a form, or No form, tags only.
- Add up to 5 Tags. With No form, tags only, at least one tag is needed.
- Click Save destination.
- The Form menu lists your active Kit forms.
- Tags that do not exist yet in Kit are created the first time a lead needs them.
- Kit sequences cannot be chosen directly. To start a sequence, set up an automation in Kit that starts when someone joins the form or gets the tag.
All the other options (sending existing leads, pausing, statuses): Send your leads to your email tool.
Confirmation emails in Kit
PlayerMagick has no double opt-in switch for Kit: Kit uses the chosen form's own confirmation setting.
- A form that asks people to confirm (double opt-in): Kit sends the form's confirmation email, and the subscriber becomes active once they click it.
- A form without confirmation (single opt-in): the subscriber is active at once.
- No form, tags only: contacts are added without a confirmation email.
To check or change it, open the form in Kit and look in its settings for the incentive email (the confirmation email).
Good to know
- Someone already in Kit stays as they are; only your form and tags are added. Leads shows "Sent" with "Already on the list; tags added."
- Someone who unsubscribed, bounced or complained in Kit is never added again and gets no tags. Leads shows Not added: "this person unsubscribed in Kit before."
- Speed: Kit lets each key make about 120 requests a minute, and each new lead needs 2 or more. Leads usually arrive within seconds, but a spike of thousands of sign-ups can take a couple of hours to reach Kit. They wait safely in the meantime.
- Several Kit accounts: you can connect more than one (for example, for clients). The same Kit account cannot be connected twice.
- Automations: once Kit is connected, add
?pm_kit={{ subscriber.id }}to your email links so automations can tag the subscribers who watch; see Recognise viewers from your emails.
Error messages
| Message | What to do |
|---|---|
| "This looks like an older Kit key (v3). In Kit, go to Settings → Developer and create a v4 API key." | You pasted the v3 API key or API secret. Create a v4 key as in Step 1. |
| "Kit did not accept this key. Check that you copied the whole key." | Copy the key again, without spaces. If you deleted it in Kit, create a new one. |
| "Paste the API key from Kit." | The field is empty, or the key has spaces or line breaks in the middle. Paste it again. |
| "Kit didn't answer. Try again in a minute." | Kit did not answer within 10 seconds. Try again in a minute. |
| "Kit asked us to slow down. Try again in a minute." | Kit received too many requests for this key. Wait a minute. |
| "This key can't read your lists. Use a key of a user who can manage contacts." | The key cannot read your forms. Create a new key in Kit. |
| "This Kit account is already connected. Use Replace key on its card to change the key." | This Kit account is already in Settings → Integrations. |
After Kit is connected:
- The card shows "Key not working": the key was deleted or changed in Kit. Create a new key and click Replace key on the card. See Key not working.
- A gate says the form "no longer exists in Kit": the form was deleted or is no longer active. Choose another form. See List no longer exists.
All statuses and fixes: Fix an email tool error.
Limits
- PlayerMagick connects with an API key only; there is no "Sign in with Kit" button yet.
- Only the email address, the form and your tags are sent: no first name or custom fields.