Skip to main content

Systeme.io Integration

Systeme.io Integration Why: Connect your app to Systeme.io to automate member account creation, manage access based on purchases or cancellations,...

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: Connect your app to Systeme.io to automate member account creation, manage access based on purchases or cancellations, and keep user data in sync. This integration streamlines your operations, allowing you to focus on creating content for your subscribers.

Navigate: App Station > Settings > Integrations > Systeme.io

Quick Start

  1. Go to App Station and select Integrations.

  2. Click on Systeme.io.

  3. Enter your Systeme.io API key.

  4. Copy the webhook URL into your Systeme.io Account Settings under Webhooks.

  5. 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. It includes:

  1. Inbound Webhooks: Systeme.io sends events like SALE_NEW and SALE_CANCELED to your app, which automatically provisions users and manages their access levels.

  2. Outbound API Sync: Your app pushes custom fields and applies tag rules to contacts in Systeme.io based on specific events.

Key Features

  • API Key: You need to provide your Systeme.io API key, which is securely stored for outbound sync.

  • Webhook Secret (Optional): This allows for HMAC-SHA256 verification to ensure secure communication.

  • Price Plan Mapping: You can map Systeme.io price plans to your app's access levels.

  • Renewal Handling: If a SALE_NEW event is received for an already active user, it will be logged as a renewal without duplicating access grants.

Setting Up the Integration

  1. Access the Integration Settings:

    • Navigate to App Station > Settings > Integrations > Systeme.io.

  2. Enter Your API Key:

    • Obtain your API key from Systeme.io (Profile > Public API keys) and enter it in the integration settings.

  3. Configure Webhook URL:

    • Copy the provided webhook URL and paste it into your Systeme.io Account Settings under Webhooks.

  4. Set Optional Webhook Secret:

    • If you choose to use a webhook secret, ensure it matches the one configured in Systeme.io.

  5. Map Price Plans to Access Levels:

    • You can manually map price plan IDs to access levels or allow auto-discovery after a test purchase. Optionally, set trial days (1-30) for each mapping.

  6. Configure Event Tag Mappings:

    • Set up mappings for various events, not just access grants. This allows you to manage tags effectively based on user actions.

Free Trials

You can offer optional free trials (1-30 days) for each price plan. If a SALE_NEW event arrives for a mapped plan with trial days, your app will grant access with an expiration date. If the same plan is purchased again while the trial is active, it will convert to full access.

Important Notes

  • Ensure that the webhook events are correctly set up in Systeme.io to trigger the desired actions in your app.

  • Regularly check the event log for any errors or issues with the integration.

Related Articles
Did this answer your question?