Platform 2 Guide — This article applies to the new platform. Looking for classic platform docs? Browse the Platform 1 collection.
Why: Streamline your member management by connecting Systeme.io to automatically create accounts, manage access based on purchases or cancellations, and sync user data back to your Systeme contacts. This integration saves you time and ensures your members have a seamless experience.
Navigate: App Station > Settings > Integrations > Systeme.io
Quick Start
Go to App Station and select Integrations.
Click on Systeme.io.
Enter your Systeme.io API key.
Copy the provided webhook URL into your Systeme.io Account Settings under Webhooks.
Map your price plan IDs to access levels.
Detailed Setup Instructions
Overview of the Integration
The Systeme.io integration allows for bidirectional communication between your app and Systeme.io. This means you can automatically provision members and manage their access based on their purchases or cancellations.
Inbound Webhooks: Systeme.io sends events such as
SALE_NEWandSALE_CANCELEDto your app. This allows your app to create users and grant or revoke access levels accordingly.Outbound API Sync: When events occur in your app (like user sign-ups or access changes), your app will push custom fields and tags to the corresponding Systeme.io contact.
Setting Up the Integration
Access the Integration Settings:
Navigate to App Station and select Integrations.
Click on Systeme.io.
Enter Your API Key:
Obtain your Systeme.io API key from your Systeme.io profile under Public API keys.
Paste the API key into the designated field in the integration settings.
Configure the Webhook:
Copy the webhook URL provided in the integration settings.
Go to your Systeme.io Account Settings and paste the webhook URL into the Webhooks section.
Optionally, set a webhook secret for added security. This secret must match what you configure in Systeme.io.
Map Price Plans to Access Levels:
You can manually map your Systeme.io price plan IDs to your app's access levels. This ensures that when a member purchases a plan, they receive the correct access level in your app.
You can also enable auto-discovery after making a test purchase to automatically map these plans.
Configure Event Tag Mappings (Optional):
Set up rules for adding or removing tags based on events. For example, you might want to add a tag when access is granted.
Understanding Webhook Events
Systeme.io will send specific events to your app, which you need to handle appropriately:
SALE_NEW (or legacy NEW_SALE): This event triggers the creation of a user if they do not already exist, grants access, or confirms a renewal for existing users.
SALE_CANCELED: This event revokes access based on the order ID provided.
Outbound Custom Fields
Your app will also sync certain custom fields back to Systeme.io, which will be auto-created if they do not already exist:
mk_subscription_status: The current subscription status of the user.mk_access_level: The name of the current access level/subscription.mk_signup_date: The date the user signed up.mk_last_login: The last time the user logged in (if tracked).
Important Notes
Ensure that your integration is enabled and that you have the necessary permissions to use the Systeme.io integration.
Regularly check the integration status and logs to troubleshoot any issues that may arise.