MailerLite API — manage subscribers, assign them to groups, create groups, and list email campaigns.

Provided free and as is, without warranty of any kind — including merchantability, fitness for a particular purpose, and the accuracy or completeness of any result. See the licence. You are responsible for checking what this produces before relying on it.

MailerLite

Manage your MailerLite subscribers, groups, and email campaigns directly from an InTouch job or the AI assistant.

This tool talks to the official MailerLite API (https://connect.mailerlite.com/api) using standard-library Python only — no external dependencies.

What it does

Read and create subscribers
Read and create groups
Assign a contact to a group
List email campaigns

Operations

operation	API call	Required params
`list-subscribers`	`GET /subscribers`	—
`get-contact`	`GET /subscribers/{id-or-email}`	`subscriberId` or `email`
`create-contact`	`POST /subscribers`	`email`
`list-groups`	`GET /groups`	—
`create-group`	`POST /groups`	`groupName`
`assign-to-group`	`POST /subscribers/{id-or-email}/groups/{group_id}`	(`subscriberId`/`email`) + `groupId`
`list-campaigns`	`GET /campaigns`	—

Parameters

param	description
`apiKey`	MailerLite API token (required). Sent as `Authorization: Bearer <token>`.
`operation`	One of the operations above (required).
`email`	Contact email — required for `create-contact`; lookup key elsewhere.
`subscriberId`	Contact id — alternative lookup key for `get-contact`/`assign-to-group`.
`groupId`	Group id — required for `assign-to-group`.
`groupName`	Group name (max 255 chars) — required for `create-group`.
`fields`	JSON object of contact field values for `create-contact`, e.g. `{"name":"Jane"}`.
`status`	Contact status for `create-contact`: `active`, `unsubscribed`, `unconfirmed`, `bounced`, `junk`.
`filterStatus`	Status filter for `list-subscribers` (same values as `status`).
`limit`	Max records for list operations (1–100, default 25).

API key setup

Sign in to your MailerLite dashboard.
Go to Integrations > API (or API under your account settings).
Generate a new token and copy it.
Pass that token as the apiKey input.

The token is sent as Authorization: Bearer <token>. A single token is all that is required — there is no OAuth/JWT exchange.

Output

Every call returns:

result — the MailerLite JSON response, serialized as a string.
status — the HTTP status code (e.g. 200, 201, 404).

The tool never throws on a non-2xx API response; it returns the status and the error body so the caller can decide how to handle it. Only transport-level failures (DNS, connection refused, timeout) cause the step to fail.

Examples

List the first 50 active subscribers:

operation:     list-subscribers
filterStatus:  active
limit:         50

Create (or upsert) a contact with custom fields:

operation:  create-contact
email:      [email protected]
fields:     {"name":"Jane","company":"Acme"}
status:     active

Create a group:

operation:  create-group
groupName:  VIP Customers

Assign a contact to a group:

operation:  assign-to-group
email:      [email protected]
groupId:    123456789

List recent campaigns:

operation:  list-campaigns
limit:      10

Publishes

The keys a later task may reference as {{taskName.key}}. Referencing anything not listed here resolves to nothing at run time.

error
result
status

Input Properties

Every property this tool accepts, from its own tool.iml.

Property	Type	Required	Default	Description
`apiKey`	string	yes	—	MailerLite API token. Create one in the MailerLite dashboard under Integrations > API. Sent as 'Authorization: Bearer '.
`operation`	string	yes	—	One of: list-subscribers, get-contact, create-contact, list-groups, create-group, assign-to-group, list-campaigns
`email`	string	no	—	Contact email address. Required for create-contact; usable as the lookup key for get-contact and assign-to-group.
`subscriberId`	string	no	—	Contact id. For get-contact and assign-to-group you may pass this instead of email.
`groupId`	string	no	—	Group id. Required for assign-to-group.
`groupName`	string	no	—	Group name (max 255 chars). Required for create-group.
`fields`	string	no	—	Optional JSON object of contact field values for create-contact, e.g. {"name":"Jane","company":"Acme"}.
`status`	string	no	—	Contact status for create-contact: active, unsubscribed, unconfirmed, bounced, or junk. Leave empty for MailerLite default.
`filterStatus`	string	no	—	Optional status filter for list-subscribers: active, unsubscribed, unconfirmed, bounced, or junk.
`limit`	string	no	`25`	Max records to return for list-subscribers, list-groups, list-campaigns (1-100). Defaults to 25.