systeme_skill

Overview

This skill provides a managed OAuth integration to the Systeme.io API via the Maton gateway. It lets you manage contacts, tags, custom contact fields, courses/enrollments, community memberships, and subscriptions using a single API surface. Network access and a valid MATON_API_KEY are required to proxy requests to Systeme.io.

How this skill works

Requests are sent to the Maton gateway at https://gateway.maton.ai/systeme/{native-api-path} with your Maton API key in the Authorization header. The gateway handles OAuth connections, selects the active Systeme.io connection (or uses the one specified with Maton-Connection), and forwards requests to api.systeme.io while translating auth headers and enforcing rate limits. Use standard HTTP verbs and content types (including application/merge-patch+json for PATCH).

When to use it

• Sync or bulk-manage Systeme.io contacts and custom contact fields
• Assign or remove tags on contacts for segmentation or funnels
• Enroll or revoke student access to courses and manage enrollments
• Create or remove community memberships and list community data
• List or cancel subscriptions and inspect payment-related state

Best practices

• Set MATON_API_KEY as an environment variable and keep it secret
• Specify Maton-Connection when you have multiple Systeme.io accounts
• Use cursor-based pagination (limit + startingAfter + order) to iterate large lists
• Use application/merge-patch+json for PATCH updates to contacts or fields
• Respect X-RateLimit-* headers and retry when you receive 429 with Retry-After

Example use cases

• Create a new contact, then immediately assign a welcome tag and enroll them in a course
• Export all contacts for CRM sync by paging with limit and startingAfter
• Automate membership provisioning to a private community after purchase
• Cancel a customer subscription programmatically from a support dashboard
• Create and update custom contact fields for richer segmentation