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 connecting your Kit account. This integration allows you to automate subscriber updates based on app events, helping you engage your audience more effectively.
Navigate: App Station > Settings > Integrations > Kit
Quick Start
Click on Kit in the Integrations section of the App Station.
Enter your Kit API key and click Save.
Configure your event mappings to determine which tags to add or remove based on app events.
Set up your custom field mappings if needed.
Test the connection to ensure everything is working properly.
Detailed Setup Instructions
Step 1: Connect Your Kit Account
To start using the Kit integration, you need to connect your Kit account by providing your API key.
Go to the Integrations section in the App Station.
Click on Kit.
Enter your Kit API key in the provided field.
Click Save to establish the connection.
Step 2: Configure Event Mappings
Event mappings determine how app events trigger actions in Kit, such as adding or removing tags from subscribers.
In the Kit integration settings, find the Event Mappings section.
Define which tags to add or remove for each event. For example:
For a new subscriber event, you might want to add a tag like "New Member."
For a subscription cancellation, you could remove the "Active Member" tag and add a "Cancelled" tag.
Save your mappings.
Tip: You can customize the tags based on your specific needs to better segment your audience.
Step 3: Set Up Custom Field Mappings
By default, the integration uses predefined mappings for custom fields. If you want to customize these:
Locate the Field Mappings section in the Kit settings.
Map your Member Kitchens fields to the corresponding Kit custom fields. For example, you might map
mk_subscription_planto a custom field in Kit that tracks the subscription plan.Save your changes.
Step 4: Test the Connection
Before fully relying on the integration, it's essential to test the connection to ensure everything is set up correctly.
In the Kit integration settings, click on the Test Connection button.
If successful, you will see a confirmation message indicating that the connection is active.
Note: If you encounter any errors, double-check your API key and ensure that it has the necessary permissions in your Kit account.
Supported Events
The integration supports several key events that trigger actions in Kit:
user.signed_up: Creates or updates a subscriber in Kit.
subscription.started: Tags the subscriber as a paying member.
subscription.canceled: Removes the active tag and adds a "Cancelled" tag.
access.granted: Tags the subscriber based on their access level.
Understanding these events helps you effectively manage your subscriber list and tailor your communications.