Integrating with Kit (formerly ConvertKit)

HERO-brand-identity-scaled.jpg

While in the Landing Pages list, click on the name of the desired page and select Integrations -> Form Integrations:

1._How_to_access_the_integration_on_the_page.gif

If you have already connected your Kit account to Instapage, you will see it here and you can select it. Otherwise, you will see this screen and you can go to the main Integrations Dashboard to connect.

2._No_integration_error.png

On the menu on the left side of the dashboard, click on the name of the workspace you want, Workspace Settings - Integrations, and look for the Kit Integration.

3.look_for_CKIT.gif

Sign in and connect the account. This step is done once per workspace. 

Our direct integration is using the API of ConverKit and in order to correctly connect your Kit account, you need to be the Kit account owner or a team member/user with API permissions.

To get your API secret code, click on the name of the account - Settings - Advanced - API.

KIT API KEY.gif

NOTE: Only one account can be connected at a time, even if you have the option of adding more accounts to the list. 

When you have connected the account, come back to the slideout menu for the page you want to integrate with Kit and continue with the steps below.

5.select_account_Convert_kit.gif

Note that the form must be added in Kit first. Go to Grow > Landing Pages & Forms.

create form.gif

Now select the form you want to use from the Instapage Kit integration;

form name in KIT.png

Enter or select the tags you want to use;

7.select_tag.png

Now map your Instapage fields to match the ones in Kit;

8.map_fields.gif

Field mapping is the most important step in the setup process. To ensure your leads are successfully accepted by Kit, you must adhere to the following mapping logic:

  • Map All Required Fields: Every field marked with an asterisk (*) must be mapped. If a required field is missing, the integration will fail. The 'email' field is strictly required for every submission.
  • Internal Value Matching: If a Kit field has predefined "internal values" (dropdowns, checkboxes, or radio buttons), your Instapage field must use the exact same options/values, including exact upper and lowercase, spacing, and characters.
  • Type Consistency: We strongly recommend that fields on both sides (Instapage and Kit) share the same data type (e.g., Text to Text, Number to Number).
  • The [None] Option: Selecting [None] for an Instapage field means that the specific data will not be sent to Kit.
  • Auto-Generate Functionality: Using Auto-Generate will automatically create a new text field within your Kit list properties to house that specific data.
  • Custom Fields Limitation: We support a limit of 100 custom fields. If you have more than 100 custom fields, your integration/field might not work. You can either delete the extra fields or use predefined ones in this case.

If you went through all the steps, click on FINISH, and you should see a confirmation message.

Then click on CLOSE.

In order for the changes to save on the page, you still need to update the experience. So after clicking on CLOSE, head back to the first page slide-out to UPDATE the page experience.

 

9.finish_and_update.gif

You can check the leads in your Kit account by going to Subscribers

subscribers in KIT.gif

Note: While we try to keep all of our instructional articles that involve third-party services up to date, sometimes they make changes to their platform of which we are not aware, and, as a consequence, the user interface may differ from the provided screenshots.

Important Notes:

- The integration only works on the live URL. It can not be tested on the preview mode. When testing on the live URL, make sure that your browser is not displaying an older cached version.

- Make sure to test the integration with different addresses because if you submit the form multiple times with the same email address the integration will flag the email as spam.

- Always test your integration with real email addresses as some systems recognize fake emails.  

- All fields need to have a label/name in order for the integration to work. Please do not leave the label empty or with just space characters. You can pick the 'hide label' option for some field types.