ConvertKit Integration

This document covers the steps needed to configure the ConvertKit Design Canvas Integration.

At a glance
Last updated 8/18/2021


TCPA Warning: Please note, to be TCPA compliant you must:
  • Display your SMS capture field on a different screen from your email capture field. *Please see How to Set up a Two-Step Form for instructions to display on separate screens*
  • Cannot require the SMS capture field, it must be an optional field
More information can be found  here



Here’s a quick list of what we’ll cover in the article:

  • Connection to Justuno
  • How to Add a List
  • How to Add Fields
  • How to Hide Fields
  • Auto-Populate Fields (Collect IP Address, Coupon Code, Current Website URL, Referring URL, Previous Domain Referring URL, First URL visitor landed on)


  • Justuno Account
  • ConvertKit API Key
ConvertKit API Key

Log in to your ConvertKit account and click the icon at the top right to view your Account Settings.

Copy the "API Key".


Log in to Justuno

Navigate to and log in using your account credentials.

Edit Promotion Design

  1. Click the Promotions tab at the top
  2. Click “Edit Design” next to the desired Promotion
Click Edit Design

ADD/EDIT Email Form

    1. To ADD a new email form, select “Email Form” under the “Add Layer” option on the left side and drag it onto the Promotion Canvas. (If you have an integration set up in Step 3 of your promotion already, please disconnect it for the step 1 integration to work)
Select Email Form

       2. Click the “ConvertKit” tile and authenticate.

ConvertKit Authentication

  1. Enter the API KEY you copied earlier into the screen that appears.

ConvertKit Mailing List Selection

Once authenticated, you will see your current ConvertKit Mailing Lists appear. Select one list you would like contacts to be added to.

Select Mailing List


ConvertKit Tag Definition

After selecting a List, you will see any Tags created for that List. Select all that apply to new contacts for this List or create a new Tag.


Select tags

ConvertKit Field Definition

We provide a limited set of fields to use which you can use in the Create Form process. To view/use your ConvertKit Custom Fields, click "Load Additional Fields" and check off the fields you would like to add to the form.

If you are sending information that does not require a user to fill anything out, ensure the hidden setting is checked. We have added a few hidden fields that are commonly used:

  • Current URL (the URL a user is on when they submit the form)
  • IP address (the visitor’s IP address)
  • Coupon code (the coupon code they receive in the post engagement)
  • Referring URL (the URL the user clicked on to get to the new page in your website.)
  • Previous Domain Referring URL (the URL of the last page)
  • First URL visitor landed on (the URL the user first landed on)

Create Form

Click Create Form

Once you have finalized the fields to use, click “Create Form” and then arrange your promotion fields as desired.

Preview and Publish Your Changes

Once you have arranged all fields, be sure to SAVE and then Preview or Publish your Promotion.

Visit Justuno @