How to connect Convertful with Kit (formerly ConvertKit)

With Convertful you can easily integrate your account with Kit (formerly ConvertKit) and use widgets to grow and segment your mailing list. Just follow the guide below to set up Kit integration and set up relevant actions.

Connecting Integration #

In your site’s Integrations tab, add new integration and choose Kit. It will request your API Key and API Secret. Go to your Kit Account Settings section and press the Show link under API Secret field:

Now you see both API Key and API Secret fields to copy data from:

Fill in the credentials and press the Connect button.

Default Settings #

Once Kit is connected, by default, each widget will automatically add subscribers with the default settings that you specify in the integrations’ settings.

Note, that default settings are not mandatory and you can always specify custom forms and tags manually for each specific widget while editing its button's actions.

Mapping Custom Fields #

We try to find the most relevant Kit custom field for every Convertful field automatically. But if you need to fine-tune which fields we should use, you can do this in the integration settings, by editing Custom Fields list:

Actions #

When editing your widget's button, inside its settings you can see “On Submit Actions” / “On Click Actions” which you can use to perform actions provided by ConvertKit integration:

Add subscriber with default settings
Add subscriber to a form
Add subscriber to a sequence
Add new tag to subscriber
Remove tag from a subscriber
Update custom field

When updating custom fields you can send the dynamic data to the integration:

Widgets Display Rules #

Once the integration is connected you’ll be able to use the new Show If targeting options in the widgets’ Display Rules:

Identifying Visitors #

To target widgets by the integration’s data, Convertful needs to identify a visitor. This happens when either:

The visitor submits his/her email address via one of your widgets.
The visitor opens your site with the special conv_email tracking parameter that contains his/her email address.

So you can add the:

?conv_email={{ subscriber.email_address }}

to your Kit emails’ links, and when your subscribers open these links, they will be properly identified for targeting rules: