Integrating RightMessage with Kit

Once you’ve integrated your RightMessage account with Kit, you’ll be able to use us to capture new subscribers, segment your Kit (formerly ConvertKit) subscribers, and personalize your website with Kit tags and custom fields.

In this guide, we cover everything you need to know about segmenting and personalizing with Kit + RightMessage.

Linking RightMessage with Kit

To create a link between RightMessage and Kit, all you need to do is add your Kit API Key and API Secret to your RightMessage account.

Here’s how:

Step 1: Find your API Key and API Secret

First, log in to your Kit account and select Your Account → Account Settings

The API Key  and API Secret  data is listed right below the ‘Homepage’ dropdown.

Finding the ConvertKit API Key and API Secret

Step 2: Paste your Key and Secret into the RightMessage integration area

In RightMessage, click on 'Integration' on the left, then choose Kit.

Paste in your API Key and API Secret into the respective fields and click Connect to Kit .


That’s it!

Identifying Kit subscribers on your website

There are a handful of ways that RightMessage “knows” when someone on your website is also in your Kit account.

For information on how we identify visitors, you’re going to want to read this crash course guide first. Once you’ve read that, here are the nuances specific to Kit…

ID’ing whenever you send an email

Kit can optionally attach a ck_subscriber_id  URL parameter to every link that it includes in a Kit-sent email. You’re going to want to enable this – once enabled, you’ll never need to worry about ensuring that your RightMessage-backed website knows when a Kit subscriber is on your website.

First, log in to your Kit account and select Your Account → Account Settings .

Now choose Email  on the left navigation menu.

At the bottom of the page (under “Advanced”), toggle Add subscriber_id parameter in email links  and then click Save Settings

Appending subscriber IDs to every outbound link

ID’ing when a Kit form is submitted

If you’re having people opt-in to a Kit form or landing page, then you’re going to need to enable one option within each form or landing page. (If you’re using RightMessage to opt people in via our Flows, there’s no need to do this – it’s automatic.)

On any form or landing page, click Settings  and choose the Advanced  tab. Toggle on Send subscriber to thank you page  and click Save.

Sending subscriber data on a ConvertKit form

This will now pass ck_subscriber_id  to your opt-in confirmation page. And as long as the RightMessage script is also included on that page, you’re good to go.

Kit forms and RightMessage’s forms?

Even if you switch entirely to using RightMessage’s forms rather than Kit’s, we recommend that you continue to create Kit forms.

Every unique offer in a Flow, like your newsletter opt-in form, should map to a complimentary newsletter opt-in form you’ve created in Kit.

You’re going to want to do this both for attribution and automation reasons. By creating this link, you’ll be able to go into any subscriber in Kit and see that they’ve submitted so-and-so forms.

You’re not going to need to worry about what you name these forms, or how they’re styled in Kit, etc. We’re just going to be using these forms as references.

The Kit data we can use to segment website visitors

When a visitor is back on your website, RightMessage has immediate access to:

  • Their list of tags
  • Their custom fields

Check out our sections on segmentationwebsite personalization, and Flows for guidance on how to use this data.

Outputting custom fields (like someone’s first name) on your website

With RightMessage, you can output known data (like custom fields) directly to your website. In our guide to adding contextual data and merge tags, we cover how to do this. But below is a bit of Kit-specific context.

To include a Kit custom field value within a text personalization, add: {{ convertkit.customFields.favorite_color }} , replacing favorite_color  with your custom field of choice. (This field should not have any spaces. Either include underscores, your_favorite_color , or leave it as a single word, industry .)

An exception should be made for outputting someone’s first name, which is a special custom field in Kit. To output the first_name  custom field, use: {{ convertkit.firstName }}

And to output someone’s email address: {{ convertkit.email }}

Note About Kit (formerly ConvertKit) Integration:

While Kit (formerly ConvertKit) has rebranded, RightMessage maintains the original 'convertkit' syntax in our implementation to ensure system stability and backward compatibility. Therefore, when working with Kit custom fields, continue using the convertkit.customFields format in your configurations.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.

Still need help? Contact Us Contact Us