ConvertKit Addon

ConvertKit Addon is a Plus Feature

Unlock ConvertKit Addon and other powerful features to grow your business.

Get WPForms Plus

Would you like to learn how to connect and use ConvertKit with WPForms? With the ConvertKit addon, you can easily send leads from your WordPress forms to your ConvertKit account.

This tutorial explains how to install and use the ConvertKit addon with WPForms.


1. Installing the ConvertKit Addon

Before you get started, you’ll first need to ensure WPForms is installed and activated on your WordPress site and that you’ve verified your license.

After that, you’ll be able to quickly install and activate the ConvertKit addon.

2. Setting Up ConvertKit Integration

After installing and activating the ConvertKit addon, you’ll need to connect your site with your ConvertKit account.

To do so, go to WPForms » Settings and then select the Integrations tab.

WPForms integration tab

Next, click on ConvertKit to reveal the details for this integration. Then click the + Add New Account button to connect your account.

Add new connection

You’ll need to enter the API Key and API Secret from your ConvertKit account dashboard.

ConvertKit integration settings

Keep this browser tab open, as we’ll return to it later.

Retrieving API Details

To get your API keys, log in to your ConvertKit account dashboard. Next, click on your company name located at the top right corner and select Settings.

ConvertKit account settings

In the Settings page, select the Advanced option to open additional settings.

Advanced settings option

Under API, you’ll see 2 API keys: Your API Key and API Secret.

ConvertKit API Section

Click the copy icon next to Your API Key to copy the API Key.

Copy API key

Saving Your API Details in WPForms

After copying your API key, return to the browser tab with WPForms open and paste the key you just copied into the ConvertKit API Key field.

Paste API key

Similarly, you’ll need to copy your API Secret from ConvertKit and paste it into the ConverKit API Secret field.

Paste API secret

When you’re ready, click the Connect to ConvertKit button to connect your account.

Click connect to ConvertKit button

You should see Connected next to the addon name after saving your changes.

Connected account

Note: You can connect multiple accounts to the ConvertKit addon. To add an additional account, click the + Add New Account button and follow the same steps to retrieve and save your API keys.

3. Using ConvertKit With Your Forms

After you’ve connected your account, you’ll be able to link ConvertKit to your WordPress forms. To proceed, create a new form or edit an existing one to access the form builder.

In the form builder, add the fields you’d like to include in your form. After that, go to Marketing » ConvertKit to access the ConvertKit configuration page.

Select ConvertKit From Marketing Option

To create a new connection, click the Add New Connection button.

Add new convertkit connection

In the overlay that appears, enter a name for your connection. This name is for internal use only, so you can use any name you like.

Enter connection nickname

Once you’ve named your connection, you’ll need to choose the account you connected under Select Account.

Select ConvertKit account

Note: You can create as many connections as you need. Simply click the Add New Connection button and select an account from the Select Account dropdown.

Choosing an Action to Perform

There are 3 available options to choose from:

Action to perform


This action lets you add a new contact to your mailing list. When selected, additional options will appear.

Select subscribe action

Below, we’ll explain the available options in more detail.


This field contains the user’s email you wish to add to your subscriber list. You’ll need to map this field to the Email field on your form.

Select email field

New Email

This optional email field is particularly useful when you create a form allowing users to update their email address on your ConvertKit account.

Select new email field

ConvertKit will replace the subscriber’s email address with the one mapped to the New Email field.

First Name

This is an optional field to capture the users’ name. This is useful if you’d like to send personalized emails to your subscribers.

Select user first name


If you’ve created any form on your ConvertKit account, you’ll be able to link the form to your WordPress form. To do so, click the Form dropdown and choose the form you’d like to connect with your WordPress form.

Select forms


Tags allow you to segment your subscribers into groups. For example, you can group users who have shown interest in a particular product and then send promotional emails to the user group.

Select tags

If you’ve set up tags on your ConvertKit dashboard, you’ll be able to choose any of them from the Tags dropdown.

New Tags

WPForms lets you create new tags that’ll be added to your ConvertKit account. You simply need to enter the tag name in the New Tags field.

Create new tags

Note: If you’d like to create multiple tags, enter the tag names in the New Tags field and separate each tag with a comma.

Custom Fields

When the Subscribe action is selected, you’ll be able to map any of your form’s Field Values to ConvertKit custom fields.

Mapping custom fields


This action allows you to remove a contact from your mailing list without deleting their information from your account.

Select email to unsubscribe

When you choose the Unsubscribe action, you only need to select the email field from your form.

Select Email to Unsubscribe

Once the form is submitted, the email address matching the one submitted through your form will be unsubscribed from your mailing list.

Remove Subscriber’s Tags

Use this option if you’d like to delete a subscriber from a specific tag(s) on your ConvertKit account. Once selected, you’ll need to map the email field on your form to the Email field in ConvertKit.

Map email field to remove tags

Next, you’ll need to choose the tag(s) you’d like to remove the user from in the Tags field.

Select tags to remove

Enabling Conditional Logic

Conditional logic allows you to configure rules that must be met for the connection to work. Once you enable it, you can set any rule(s) you like following WPForms conditional logic system.

Enabling conditional logic

For example, we can add the Checkboxes field with one option requesting the users’ permission before adding them as subscribers.

Then in the conditional logic block, we set the rule to process this connection if Join Our Newsletter? is Yes.

Configuring conditional logic

Note: For more details on using conditional logic in WPForms, we recommend checking out our conditional logic tutorial.

That’s it! Now you know how to install and use the ConvertKit addon with WPForms.

Next, would you like to learn how to create a dedicated lead-capturing form? Check our tutorial to learn how to use the Lead Forms addon.