SystemIO Integration

Automatically sync contacts and tags from SystemIO to Lumail using webhooks. This integration allows you to centralize your email marketing data and leverage Lumail's advanced segmentation and automation features with your SystemIO audience.

What is SystemIO?

SystemIO is an all-in-one marketing platform that includes sales funnels, email marketing, course hosting, and webinar capabilities. With this integration, you can sync your SystemIO contacts and activity to Lumail in real-time.

How It Works

When events occur in SystemIO (new opt-ins, tag changes), SystemIO sends webhook notifications to Lumail. The integration:

1. Verifies the webhook authenticity using HMAC-SHA256 signature
2. Processes the event (creates subscribers, syncs tags)
3. Updates your Lumail database in real-time
4. Records all events in the subscriber timeline

Setup Instructions

Follow these steps to connect your SystemIO account to Lumail.

Step 1: Get Your Organization Slug and Token

First, you need to get your organization slug and generate an API token.

1. Visit your organization settings page
2. Get your slug from the URL (e.g., melvynx in the screenshot below)

3. Click "Generate Token" and give it a name like "SystemIO"
4. Copy the generated token - you'll need it in the next step

Step 2: Create the Webhook in SystemIO

Now you'll configure the webhook in your SystemIO account.

1. Go to SystemIO Webhook Settings

2. Click "Create" to add a new webhook

3. Fill in the form with these values:

   • Name: Lumail.io
   • URL: https://lumail.io/api/orgs/<your-org-slug>/systemio
     • Replace <your-org-slug> with your actual slug (e.g., https://lumail.io/api/orgs/melvynmal-e0fb/systemio)
   • Secret: Paste the API token you generated in Step 1

4. Select the events you want to sync:

   • ✅ Contact Created - Syncs new opt-ins
   • ✅ Contact Tag Added - Syncs tag additions
   • ✅ Contact Tag Removed - Syncs tag removals

5. Your filled form should look like this:

6. Click "Save" to activate the webhook

Step 3: Test the Integration

To verify the integration is working:

1. Add a test contact in SystemIO with some tags
2. Check your Lumail organization's subscribers list
3. The contact should appear with all synced tags
4. Check the subscriber's timeline to see the sync events

Supported Events

The SystemIO integration automatically syncs the following events:

Contact Created (CONTACT_CREATED)

When a new contact opts in to your SystemIO list:

• Creates or updates the subscriber in Lumail
• Syncs all contact fields (first name, last name, phone)
• Applies all existing tags from SystemIO
• Records the event in the subscriber timeline

Contact Tag Added (CONTACT_TAG_ADDED)

When a tag is added to a contact in SystemIO:

• Creates or updates the subscriber in Lumail
• Adds the tag to the subscriber (creates tag if it doesn't exist)
• Records the tag addition in the subscriber timeline

Contact Tag Removed (CONTACT_TAG_REMOVED)

When a tag is removed from a contact in SystemIO:

• Removes the tag from the subscriber in Lumail
• Records the tag removal in the subscriber timeline
• Keeps the subscriber active

Security

The integration uses HMAC-SHA256 signature verification to ensure all webhook requests are authentic and come from SystemIO. Each webhook request is validated using the secret token you configured, preventing unauthorized access.

Troubleshooting

Webhook not working?

1. Check the webhook URL: Make sure you replaced <your-org-slug> with your actual organization slug
2. Verify the token: Ensure you copied the complete token without extra spaces
3. Check webhook events: Make sure you subscribed to the correct events in SystemIO
4. Review logs: Check your subscriber timeline for any error messages

Contacts not syncing?

• Verify the webhook is active in SystemIO
• Check that the contact has a valid email address
• Ensure the webhook events are properly configured in SystemIO

Tags not appearing?

• Tags are automatically created in Lumail if they don't exist
• Check the subscriber's tags section to see all synced tags
• Review the subscriber timeline for tag addition events

Related Documentation

• SystemIO Webhook Documentation
• SystemIO API Reference
• Lumail API Reference - Complete API documentation
• API Tokens - Create and manage API tokens
• Tags API - Manage synced tags
• Subscriber Events - View integration events in timeline