How to use the systeme.io public API (Application Programming Interface)

In this article, you will learn how to configure and use the systeme.io public API, including how to generate API keys and what actions you can perform.

1. What is an API?

The acronym API stands for "Application Programming Interface", a series of instructions by which a platform offers services to other platforms. It's a strategic gateway for external developers, enabling them to access specific functionality or data from a platform in a structured, secure way. It's like a set of ready-to-use tools that make it easy to build new applications, services, or combinations.

In short, systeme.io opens up to other platforms to offer its services where it has added value.

2. How does our public API work?

Our API exposes a carefully selected set of features, enabling developers to interact with our platform transparently and efficiently. If you'd like to know more about how it works, you can read our official API documentation.

3. How to generate your API keys

API keys are unique identifiers that authenticate requests to our Public API. They enable you to programmatically access and manage various resources on our platform.

To create a public API key, click your profile picture, select Settings (1), and scroll down to MCP & API keys (2).

Click Create (3) to start creating a public API key.

In the Create public API key popup, enter a name, and select an expiration date and time for your API key.

Once done, click Save (4).

Your key is now ready.

4. What can you do with our API?

Our API opens up some interesting possibilities. Below you will find the main actions you can perform using our public API:

a. Contacts, tags, and custom fields:

• Manage contacts: Create new contacts, update existing ones, list your audience with advanced filters, or delete contacts.
• Manage tags: Create, assign, list, and remove tags from contacts.
• Custom fields: Retrieve available contact custom fields and their identifiers (slugs) to correctly fill in contact information.

b. Newsletters:

• Create and update newsletters: Create new newsletter drafts or partially update existing ones. You can define the editor type (Classic or Visual), retrieve the full HTML content, and explicitly set the sender's name and email address.
• List and retrieve: Browse your existing newsletters or fetch the full content of a specific newsletter using its ID.

c. Funnels and Page editor:

• Manage funnels: Create new funnels, add new steps (pages) to them, and fetch a list of all individual steps within a specific funnel.
• Page editor: Save generated page content directly to your funnel steps or website pages (full replace), and retrieve JSON schemas for specific page types.

d. Price plans and coupons:

• Create, edit, and delete: Generate new price plans and coupons, or partially update and delete existing ones.
• List and search: Browse through all your existing price plans and coupons, or fetch specific items by their ID.

e. Courses and students:

• Manage courses and students: Fetch a list of your existing courses and retrieve a list of students currently enrolled.
• Enroll students: Programmatically enroll contacts into your individual courses.

f. Communities:

• Manage communities: Retrieve a list of your existing communities and access a list of the current members within a specific community.
• Invite members: Programmatically invite new users to join your communities by providing their contact ID.

g. Automation rules:

• Manage rules: Programmatically connect common events and actions, update existing rules (e.g., changing an action while keeping the trigger the same), or soft-delete rules.
• List and retrieve: Browse your automation rules or fetch a specific rule by its ID.

h. Subscriptions:

• Manage subscriptions: Retrieve a list of all resources in a subscription from third-party platforms, and cancel a subscription either immediately or at the end of the billing cycle.

i. Webhooks

• Manage webhooks: Programmatically create new webhooks to receive real-time notifications, retrieve lists of your existing webhooks, and remove webhooks that are no longer needed.

Learn more: API documentations.