Skip to main content

Kit (ConvertKit) Integration

Kit (ConvertKit) Integration Why: Seamlessly manage your email subscribers and tags by integrating Kit with your app. This connection allows you to...

Written by Ken Truesdale

Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.

Why: Seamlessly manage your email subscribers and tags by integrating Kit with your app. This connection allows you to automate subscriber updates based on app events, enhancing your marketing efforts and subscriber engagement.

Navigate: App Station > Settings > Integrations > Kit

Quick Start

  1. Click Add Integration in the Kit section.

  2. Enter your Kit API key and click Save.

  3. Configure your event mappings to specify which tags to add or remove for each event.

  4. Enable the integration by toggling the Active switch.

  5. Test the connection to ensure everything is set up correctly.


Detailed Setup Instructions

Connecting Your Kit Account

To start using the Kit integration, you'll need to connect your Kit account:

  1. Go to the Integrations section in the App Station.

  2. Click on Kit and then Add Integration.

  3. Enter your Kit API key. This key allows your app to communicate with Kit and manage subscribers.

  4. Click Save to store your API key.

Configuring Event Mappings

Event mappings determine how your app interacts with Kit based on specific actions. Here’s how to set them up:

  1. In the Kit integration settings, find the Event Mappings section.

  2. Define the events that will trigger actions in Kit. For example:

    • User Signed Up: Add a tag to identify new subscribers.

    • Subscription Started: Tag subscribers as paying members.

    • Subscription Canceled: Remove the active tag and add a "canceled" tag.

You can customize these mappings to fit your needs. Each event can have multiple tag actions associated with it.

Syncing Subscription Data

The integration allows you to sync subscription details with Kit. This includes:

  • Billing cycle

  • Price

  • Plan name

These details are stored as custom fields in Kit, prefixed with "mk_" to distinguish them from other data.

  1. In the integration settings, enable the option to sync subscription data.

  2. Ensure that the necessary custom fields exist in your Kit account. You can create missing custom fields directly from the integration settings.

Monitoring Connection Health

It's important to keep track of your integration's performance:

  • Check the Last Sync Status to see if your last sync was successful or if there were errors.

  • Use the Test Connection feature to verify that your API key is working correctly.

Supported Events

Here are some key events that trigger actions in Kit:

MK Event

Kit Action

Use Case

user.signed_up

Create or update subscriber

Grow your email list

subscription.started

Tag subscriber

Identify paying members

subscription.canceled

Remove active tag, add "canceled" tag

Segment churned users

access.granted

Tag with access level name

Segment by membership tier

access.revoked

Remove access level tag

Clean up inactive members

Important Notes

  • Admins can manage the integration settings and monitor sync statuses directly from the App Station.

  • Ensure that your API key is kept secure and not shared with unauthorized users.

  • Remember that the integration is available only on the Growth plan.

Did this answer your question?