# Systeme.io

> Work with your Systeme.io marketing account: create, find, update and tag contacts, manage tags and custom contact fields, enroll contacts in courses, create discount coupons, and manage webhooks.

App · 30 actions. Web page: https://docs.lodol.com/docs/integrations/systeme-io

## Actions

### Add tag to contact

Give a contact a tag, which can start automations that watch for it.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.
- Tag (`tag_id`, text, required): The tag. Pick one, or give its id from an earlier step.

**Outputs**

- `added` (true/false): Always true once added
- `contact_id` (number): The contact tagged
- `tag_id` (number): The tag added

**Example output**

```json
{
  "added": true,
  "contact_id": 4521,
  "tag_id": 301
}
```

### Create contact

Add a contact with an email address, and optionally a language, custom fields and tags. The email address cannot be changed afterwards.

**Inputs**

- Email (`email`, text, required): The contact's email address.
- Language (`locale`, text): The contact's language, used for the emails Systeme.io sends them. One of: `en` (English), `fr` (French), `es` (Spanish), `it` (Italian), `pt` (Portuguese), `de` (German), `nl` (Dutch), `ru` (Russian), `jp` (Japanese), `tr` (Turkish), and 18 more.
- Fields (`fields`, object): Contact fields to fill in, each with the field's slug and the value, for example {"first_name": "Jo", "surname": "Bloggs"}. See 'List contact fields' for the slugs.
- Tags (`tags`, list): Tags to give the contact.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "bounced": false,
    "email": "jo@example.com",
    "fields": [
      {
        "fieldName": "First name",
        "slug": "first_name",
        "value": "Jo"
      }
    ],
    "id": 4521,
    "locale": "en",
    "needsConfirmation": false,
    "registeredAt": "2026-10-15T09:00:00+00:00",
    "sourceURL": "https://example.systeme.io/optin",
    "tags": [
      {
        "id": 301,
        "name": "Newsletter"
      }
    ],
    "unsubscribed": false
  }
}
```

### Create contact field

Add a custom field that contacts can hold a value in.

**Inputs**

- Field name (`field_name`, text, required): The name shown in Systeme.io, such as Company size.
- Slug (`slug`, text, required): The field's key, used when filling it in. Lowercase letters, digits and underscores, starting with a letter.

**Outputs**

- `field` (object): The contact field

**Example output**

```json
{
  "field": {
    "fieldName": "Company size",
    "slug": "company_size"
  }
}
```

### Create coupon

Create a discount code customers can enter at checkout.

**Inputs**

- Name (`inner_name`, text, required): A name only you see, to tell the coupon apart.
- Code (`code`, text, required): What customers type at checkout. No spaces.
- Discount type (`discount_type`, text, required): A percentage off, or a fixed amount off. One of: `percent` (Percentage off), `fixed` (Fixed amount off).
- Discount (`discount_amount`, number, required): The percentage (1 to 100) or the amount off, in the currency chosen below. At least 0.
- Currency (`currency`, text, required): The currency the coupon applies to. One of: `aud`, `cad`, `dkk`, `eur`, `hkd`, `ils`, `jpy`, `mxn`, `nzd`, `nok`, and 48 more.
- Expires (`expiration_date`, date and time): When the coupon stops working. Leave empty for no change (no expiry for a new coupon).
- Uses allowed (`limit_of_use`, number): How many times the coupon can be used in total. Leave empty for no change (unlimited for a new coupon). At least 1.

**Outputs**

- `coupon` (object): The coupon

**Example output**

```json
{
  "coupon": {
    "active": true,
    "code": "LAUNCH10",
    "currency": "usd",
    "discountAmount": 10,
    "discountType": "percent",
    "expirationDate": "2026-12-31T23:59:00+00:00",
    "id": 55,
    "innerName": "Launch offer",
    "limitOfUse": 100
  }
}
```

### Create tag

Create a tag to label contacts with.

**Inputs**

- Name (`name`, text, required): The tag's name, at most 64 characters.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "tag": {
    "createdAt": "2026-10-15T09:00:00+00:00",
    "id": 301,
    "name": "Newsletter"
  }
}
```

### Create webhook

Have Systeme.io post the events you choose to an https address. The result includes the secret each delivery is signed with, which Systeme.io never shows again.

**Inputs**

- Name (`name`, text, required): A name to tell the webhook apart in Systeme.io.
- Address (`url`, text, required): The https:// address to send events to.
- Events (`events`, list, required): Which events to send. One or more of: `CONTACT_CREATED` (A contact is created), `CONTACT_OPT_IN` (A contact opts in), `CONTACT_TAG_ADDED` (A tag is added to a contact), `CONTACT_TAG_REMOVED` (A tag is removed from a contact), `SALE_NEW` (A new sale is made), `SALE_CANCELED` (A sale is canceled).
- Signing secret (`secret`, text): The secret to sign each delivery with. Leave empty to have one made for you.

**Outputs**

- `secret` (text): The secret deliveries are signed with
- `webhook` (object): The webhook

**Example output**

```json
{
  "secret": "3f9a1c0be27d45d6",
  "webhook": {
    "active": true,
    "id": "wh_01HXAMPLE",
    "name": "Send to CRM",
    "subscriptions": [
      {
        "disabledAt": "",
        "disabledReason": "",
        "event": "CONTACT_CREATED",
        "id": "sub_01HX",
        "schemaVersion": 1
      }
    ],
    "url": "https://example.com/systeme"
  }
}
```

### Delete contact

Delete a contact. Systeme.io may keep its data for several days, and a contact added again with the same email can inherit it.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.

**Outputs**

- `contact_id` (number): The contact deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "contact_id": 4521,
  "deleted": true
}
```

### Delete contact field

Delete a custom contact field and the values contacts hold in it.

**Inputs**

- Contact field (`slug`, text, required): The contact field. Pick one, or give its slug (such as company_size).

**Outputs**

- `deleted` (true/false): Always true once deleted
- `slug` (text): The field deleted

**Example output**

```json
{
  "deleted": true,
  "slug": "company_size"
}
```

### Delete coupon

Delete a coupon so its code stops working.

**Inputs**

- Coupon (`coupon_id`, text, required): The coupon. Pick one, or give its id from an earlier step.

**Outputs**

- `coupon_id` (number): The coupon deleted
- `deleted` (true/false): Always true once deleted

**Example output**

```json
{
  "coupon_id": 55,
  "deleted": true
}
```

### Delete tag

Delete a tag, which takes it off every contact that has it.

**Inputs**

- Tag (`tag_id`, text, required): The tag. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `tag_id` (number): The tag deleted

**Example output**

```json
{
  "deleted": true,
  "tag_id": 301
}
```

### Delete webhook

Delete a webhook so Systeme.io stops sending to it.

**Inputs**

- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its id from an earlier step.

**Outputs**

- `deleted` (true/false): Always true once deleted
- `webhook_id` (text): The webhook deleted

**Example output**

```json
{
  "deleted": true,
  "webhook_id": "wh_01HXAMPLE"
}
```

### Enroll contact in course

Give a contact access to a course, in full or released over time.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.
- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.
- Access (`access_type`, text): Full access to every lesson, or lessons released over time. Defaults to full access. One of: `full_access` (Full access (default)), `dripping_content` (Content released over time).

**Outputs**

- `enrollment` (object): The enrollment

**Example output**

```json
{
  "enrollment": {
    "accessType": "full_access",
    "active": true,
    "contact": {
      "email": "jo@example.com",
      "id": 4521
    },
    "course": {
      "active": true,
      "id": 77,
      "name": "Intro course",
      "path": "intro"
    },
    "id": 880
  }
}
```

### Get contact

Get one contact with its language, custom fields and tags.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "bounced": false,
    "email": "jo@example.com",
    "fields": [
      {
        "fieldName": "First name",
        "slug": "first_name",
        "value": "Jo"
      }
    ],
    "id": 4521,
    "locale": "en",
    "needsConfirmation": false,
    "registeredAt": "2026-10-15T09:00:00+00:00",
    "sourceURL": "https://example.systeme.io/optin",
    "tags": [
      {
        "id": 301,
        "name": "Newsletter"
      }
    ],
    "unsubscribed": false
  }
}
```

### Get coupon

Get one coupon with its code, discount and limits.

**Inputs**

- Coupon (`coupon_id`, text, required): The coupon. Pick one, or give its id from an earlier step.

**Outputs**

- `coupon` (object): The coupon

**Example output**

```json
{
  "coupon": {
    "active": true,
    "code": "LAUNCH10",
    "currency": "usd",
    "discountAmount": 10,
    "discountType": "percent",
    "expirationDate": "2026-12-31T23:59:00+00:00",
    "id": 55,
    "innerName": "Launch offer",
    "limitOfUse": 100
  }
}
```

### Get course

Get one course with its address, language and modules.

**Inputs**

- Course (`course_id`, text, required): The course. Pick one, or give its id from an earlier step.

**Outputs**

- `course` (object): The course

**Example output**

```json
{
  "course": {
    "active": true,
    "description": "A first course.",
    "domainName": "learn.example.com",
    "id": 77,
    "locale": "en",
    "modules": [
      {
        "id": 9,
        "name": "Welcome"
      }
    ],
    "name": "Intro course",
    "path": "intro"
  }
}
```

### Get tag

Get one tag.

**Inputs**

- Tag (`tag_id`, text, required): The tag. Pick one, or give its id from an earlier step.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "tag": {
    "createdAt": "2026-10-15T09:00:00+00:00",
    "id": 301,
    "name": "Newsletter"
  }
}
```

### Get webhook

Get one webhook with its address, state and subscriptions.

**Inputs**

- Webhook (`webhook_id`, text, required): The webhook. Pick one, or give its id from an earlier step.

**Outputs**

- `webhook` (object): The webhook

**Example output**

```json
{
  "webhook": {
    "active": true,
    "id": "wh_01HXAMPLE",
    "name": "Send to CRM",
    "subscriptions": [
      {
        "disabledAt": "",
        "disabledReason": "",
        "event": "CONTACT_CREATED",
        "id": "sub_01HX",
        "schemaVersion": 1
      }
    ],
    "url": "https://example.com/systeme"
  }
}
```

### List contact fields

List the fields a contact can hold, built in and custom, with their slugs.

**Inputs**: None.

**Outputs**

- `count` (number): How many on this page
- `fields` (list): The contact fields
- `has_more` (true/false): True if there are more after this page
- `next_cursor` (text): Pass as 'starting after' to get the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "fields": [
    {
      "fieldName": "Company size",
      "slug": "company_size"
    }
  ],
  "has_more": false,
  "next_cursor": ""
}
```

### List contacts

List contacts, filtered by email, tags, state or when they registered. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Email (`email`, text): Only the contact with exactly this email address.
- Tags (`tags`, list): Only contacts that have all of these tags.
- Registered after (`registered_after`, date and time): Only contacts who registered after this date and time.
- Registered before (`registered_before`, date and time): Only contacts who registered before this date and time.
- Unsubscribed (`unsubscribed`, text): Only contacts who have, or have not, unsubscribed. One of: `any` (Either), `yes`, `no`.
- Bounced (`bounced`, text): Only contacts whose emails have, or have not, bounced. One of: `any` (Either), `yes`, `no`.
- Awaiting confirmation (`needs_confirmation`, text): Only contacts who still have, or no longer have, to confirm their email. One of: `any` (Either), `yes`, `no`.
- Page size (`limit`, number): How many to return, 10 to 100. From 10 to 100.
- Starting after (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.
- Order (`order`, text): Newest first or oldest first. Keep it the same from page to page. One of: `desc` (Newest first (default)), `asc` (Oldest first).

**Outputs**

- `contacts` (list): The contacts
- `count` (number): How many on this page
- `has_more` (true/false): True if there are more after this page
- `next_cursor` (text): Pass as 'starting after' to get the next page; empty on the last one

**Example output**

```json
{
  "contacts": [
    {
      "bounced": false,
      "email": "jo@example.com",
      "fields": [
        {
          "fieldName": "First name",
          "slug": "first_name",
          "value": "Jo"
        }
      ],
      "id": 4521,
      "locale": "en",
      "needsConfirmation": false,
      "registeredAt": "2026-10-15T09:00:00+00:00",
      "sourceURL": "https://example.systeme.io/optin",
      "tags": [
        {
          "id": 301,
          "name": "Newsletter"
        }
      ],
      "unsubscribed": false
    }
  ],
  "count": 1,
  "has_more": false,
  "next_cursor": ""
}
```

### List coupons

List discount coupons, or those matching a search text. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Search (`query`, text): Only coupons whose name or code matches this text.
- Page size (`limit`, number): How many to return, 10 to 100. From 10 to 100.
- Starting after (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.
- Order (`order`, text): Newest first or oldest first. Keep it the same from page to page. One of: `desc` (Newest first (default)), `asc` (Oldest first).

**Outputs**

- `count` (number): How many on this page
- `coupons` (list): The coupons
- `has_more` (true/false): True if there are more after this page
- `next_cursor` (text): Pass as 'starting after' to get the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "coupons": [
    {
      "active": true,
      "code": "LAUNCH10",
      "currency": "usd",
      "discountAmount": 10,
      "discountType": "percent",
      "expirationDate": "2026-12-31T23:59:00+00:00",
      "id": 55,
      "innerName": "Launch offer",
      "limitOfUse": 100
    }
  ],
  "has_more": false,
  "next_cursor": ""
}
```

### List courses

List the account's courses, filtered by name or whether they are active. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Search (`query`, text): Only courses, modules or lectures whose name matches this text.
- Active (`active`, text): Only courses that are, or are not, active. One of: `any` (Either), `yes`, `no`.
- Page size (`limit`, number): How many to return, 10 to 100. From 10 to 100.
- Starting after (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.
- Order (`order`, text): Newest first or oldest first. Keep it the same from page to page. One of: `desc` (Newest first (default)), `asc` (Oldest first).

**Outputs**

- `count` (number): How many on this page
- `courses` (list): The courses
- `has_more` (true/false): True if there are more after this page
- `next_cursor` (text): Pass as 'starting after' to get the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "courses": [
    {
      "active": true,
      "description": "A first course.",
      "domainName": "learn.example.com",
      "id": 77,
      "locale": "en",
      "modules": [
        {
          "id": 9,
          "name": "Welcome"
        }
      ],
      "name": "Intro course",
      "path": "intro"
    }
  ],
  "has_more": false,
  "next_cursor": ""
}
```

### List enrollments

List course enrollments, for one course or one contact. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Course (`course_id`, text): Only enrollments in this course.
- Contact ID (`contact_id`, text): Only enrollments of this contact, by id.
- Page size (`limit`, number): How many to return, 10 to 100. From 10 to 100.
- Starting after (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.
- Order (`order`, text): Newest first or oldest first. Keep it the same from page to page. One of: `desc` (Newest first (default)), `asc` (Oldest first).

**Outputs**

- `count` (number): How many on this page
- `enrollments` (list): The enrollments
- `has_more` (true/false): True if there are more after this page
- `next_cursor` (text): Pass as 'starting after' to get the next page; empty on the last one

**Example output**

```json
{
  "count": 1,
  "enrollments": [
    {
      "accessType": "full_access",
      "active": true,
      "contact": {
        "email": "jo@example.com",
        "id": 4521
      },
      "course": {
        "active": true,
        "id": 77,
        "name": "Intro course",
        "path": "intro"
      },
      "id": 880
    }
  ],
  "has_more": false,
  "next_cursor": ""
}
```

### List tags

List the account's tags, or those matching a search text. Gets one page; to see more, run it again with the next page it gives.

**Inputs**

- Search (`query`, text): Only tags whose name matches this text.
- Page size (`limit`, number): How many to return, 10 to 100. From 10 to 100.
- Starting after (`starting_after`, text): The 'next_cursor' from an earlier page, to get the page after it.
- Order (`order`, text): Newest first or oldest first. Keep it the same from page to page. One of: `desc` (Newest first (default)), `asc` (Oldest first).

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True if there are more after this page
- `next_cursor` (text): Pass as 'starting after' to get the next page; empty on the last one
- `tags` (list): The tags

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "tags": [
    {
      "createdAt": "2026-10-15T09:00:00+00:00",
      "id": 301,
      "name": "Newsletter"
    }
  ]
}
```

### List webhooks

List the account's webhooks with their addresses and the events each is subscribed to.

**Inputs**: None.

**Outputs**

- `count` (number): How many on this page
- `has_more` (true/false): True if there are more after this page
- `next_cursor` (text): Pass as 'starting after' to get the next page; empty on the last one
- `webhooks` (list): The webhooks

**Example output**

```json
{
  "count": 1,
  "has_more": false,
  "next_cursor": "",
  "webhooks": [
    {
      "active": true,
      "id": "wh_01HXAMPLE",
      "name": "Send to CRM",
      "subscriptions": [
        {
          "disabledAt": "",
          "disabledReason": "",
          "event": "CONTACT_CREATED",
          "id": "sub_01HX",
          "schemaVersion": 1
        }
      ],
      "url": "https://example.com/systeme"
    }
  ]
}
```

### Remove enrollment

Take a contact's access to a course away.

**Inputs**

- Enrollment ID (`enrollment_id`, text, required): The enrollment's id, from 'List enrollments' or 'Enroll contact in course'.

**Outputs**

- `deleted` (true/false): Always true once removed
- `enrollment_id` (number): The enrollment removed

**Example output**

```json
{
  "deleted": true,
  "enrollment_id": 880
}
```

### Remove tag from contact

Take a tag off a contact.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.
- Tag (`tag_id`, text, required): The tag. Pick one, or give its id from an earlier step.

**Outputs**

- `contact_id` (number): The contact untagged
- `removed` (true/false): Always true once removed
- `tag_id` (number): The tag removed

**Example output**

```json
{
  "contact_id": 4521,
  "removed": true,
  "tag_id": 301
}
```

### Rename contact field

Change the name a custom contact field is shown with. Its slug stays the same.

**Inputs**

- Contact field (`slug`, text, required): The contact field. Pick one, or give its slug (such as company_size).
- New name (`field_name`, text, required): The name to show in Systeme.io.

**Outputs**

- `field` (object): The contact field

**Example output**

```json
{
  "field": {
    "fieldName": "Company size",
    "slug": "company_size"
  }
}
```

### Rename tag

Give a tag a new name. Contacts keep the tag.

**Inputs**

- Tag (`tag_id`, text, required): The tag. Pick one, or give its id from an earlier step.
- New name (`name`, text, required): The tag's new name, at most 64 characters.

**Outputs**

- `tag` (object): The tag

**Example output**

```json
{
  "tag": {
    "createdAt": "2026-10-15T09:00:00+00:00",
    "id": 301,
    "name": "Newsletter"
  }
}
```

### Update contact

Change a contact's language or custom fields. Anything left empty stays as it is.

**Inputs**

- Contact ID (`contact_id`, text, required): The contact's id, from 'List contacts', 'Create contact' or an earlier step.
- Language (`locale`, text): The contact's language, used for the emails Systeme.io sends them. One of: `en` (English), `fr` (French), `es` (Spanish), `it` (Italian), `pt` (Portuguese), `de` (German), `nl` (Dutch), `ru` (Russian), `jp` (Japanese), `tr` (Turkish), and 18 more.
- Fields (`fields`, object): Contact fields to change, each with the field's slug and the new value, for example {"first_name": "Jo"}. A field given an empty value is cleared; fields not listed are left as they are.

**Outputs**

- `contact` (object): The contact

**Example output**

```json
{
  "contact": {
    "bounced": false,
    "email": "jo@example.com",
    "fields": [
      {
        "fieldName": "First name",
        "slug": "first_name",
        "value": "Jo"
      }
    ],
    "id": 4521,
    "locale": "en",
    "needsConfirmation": false,
    "registeredAt": "2026-10-15T09:00:00+00:00",
    "sourceURL": "https://example.systeme.io/optin",
    "tags": [
      {
        "id": 301,
        "name": "Newsletter"
      }
    ],
    "unsubscribed": false
  }
}
```

### Update coupon

Rename a coupon, or change when it expires or how many times it can be used. The code and discount cannot change.

**Inputs**

- Coupon (`coupon_id`, text, required): The coupon. Pick one, or give its id from an earlier step.
- Name (`inner_name`, text): A new name for the coupon. Leave empty to keep it.
- Expires (`expiration_date`, date and time): When the coupon stops working. Leave empty for no change (no expiry for a new coupon).
- Uses allowed (`limit_of_use`, number): How many times the coupon can be used in total. Leave empty for no change (unlimited for a new coupon). At least 1.

**Outputs**

- `coupon` (object): The coupon

**Example output**

```json
{
  "coupon": {
    "active": true,
    "code": "LAUNCH10",
    "currency": "usd",
    "discountAmount": 10,
    "discountType": "percent",
    "expirationDate": "2026-12-31T23:59:00+00:00",
    "id": 55,
    "innerName": "Launch offer",
    "limitOfUse": 100
  }
}
```
