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, and sync user data seamlessly. This integration saves you time and ensures your members have the right access to your content.
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 webhook URL and paste it into Systeme.io under Account Settings → 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:
Inbound Webhooks: Systeme.io sends events like
SALE_NEWandSALE_CANCELEDto your app. This allows your app to automatically create users and manage their access levels.Outbound API Sync: Your app sends user data back to Systeme.io, updating custom fields and tags based on events like user sign-ups and access changes.
Setting Up the Integration
Follow these steps to connect Systeme.io to your app:
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.
Enter this key in the designated field in the Systeme.io integration settings.
Configure the Webhook
Copy the provided webhook URL.
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 the corresponding access levels in your app.
Alternatively, after making a test purchase, the system can auto-discover these mappings.
Event Tag Mappings (Optional)
Configure event-to-tag mappings to automatically apply tags based on events. For example, you can set it so that when access is granted, a specific tag is added to the user’s profile.
Understanding Webhook Events
Systeme.io sends specific events that your app uses to manage member access:
SALE_NEW: This event creates a new user if they don’t exist, grants access, or confirms a renewal for existing users.
SALE_CANCELED: This event revokes access based on the order ID.
Custom Fields and Tags
Your app will automatically create custom fields in Systeme.io if they are missing. These fields include:
mk_subscription_status: Indicates the user's subscription status.mk_access_level: Shows the current subscription or access level.mk_signup_date: The date the user was created.mk_last_login: The last time the user logged in (if tracked).
Important Notes
Ensure that your integration is set up correctly to avoid any issues with member access.
You can always check the integration logs for any errors or issues with the webhook events.