MailerLite integration

Overview

MailerLite is an email marketing platform. This tool manages subscribers — creating, retrieving, listing, and updating subscriber records. It supports both the classic (v1) and new (v2) MailerLite APIs, determined by the credential configuration. Subscriber operations include managing custom fields, subscriber status, and metadata.

Node Type

Action — processes input items and produces output

Input / Output

Direction	Port(s)
Input	Input
Output	Output, Error

Credentials

This tool requires MailerLite API credentials. See the Credentials Guide for setup instructions.

Resources

Resource	Value
Subscriber	subscriber

Operations

Operation	Value	Description
Create	create	Create a new subscriber
Get	get	Get a subscriber
Get Many	getAll	Get many subscribers
Update	update	Update a subscriber

Parameters

Subscriber: Create

Parameter	Type	Required	Default	Description
Email	string	Yes	—	Email address of the new subscriber. Supports expressions like {{ $json.email }}.
Additional Fields	collection	No	{}	Extra subscriber attributes to set alongside the email address.
— Custom Fields	fixedCollection	No	{}	Custom field key-value pairs. Field keys can be retrieved from the MailerLite dashboard under Settings > Subscriber fields, or via the GET /fields API endpoint.
— — Field Key	string	No	—	The key of the custom field. Find available fields in MailerLite dashboard under Settings > Subscriber fields, or via GET /fields API.
— — Value	string	No	—	The value to set on the custom field. Supports expressions.
— Status	options	No	—	Status of the subscriber.
				Options: active, bounced, junk, unconfirmed, unsubscribed
— Subscribed At	dateTime	No	—	Timestamp when the subscriber was added.
— IP Address	string	No	—	IP address of the subscriber.
— Opted In At	dateTime	No	—	Timestamp when the subscriber opted in.
— Opt In IP	string	No	—	IP address where the subscriber opted in.
— Unsubscribed At	dateTime	No	—	Timestamp when the subscriber unsubscribed.

Subscriber: Get

Parameter	Type	Required	Default	Description
Subscriber Email (subscriberId)	string	Yes	—	Email address of the subscriber to retrieve. Supports expressions like {{ $json.email }}.

Subscriber: Get Many

Parameter	Type	Required	Default	Description
Return All	boolean	No	false	Whether to return all results or only up to a given limit.
Limit	number	No	50	Max number of results to return. Accepts 1–100. (shown when Return All is false)
Filters	collection	No	{}	Narrow the subscribers returned.
— Status	options	No	—	Filter subscribers by status.
				Options: active, bounced, junk, unconfirmed, unsubscribed

Subscriber: Update

Parameter	Type	Required	Default	Description
Subscriber Email (subscriberId)	string	Yes	—	Email address of the subscriber to update. Supports expressions like {{ $json.email }}.
Additional Fields	collection	No	{}	The subscriber attributes to change.
— Custom Fields	fixedCollection	No	{}	Custom field key-value pairs. Field keys can be retrieved from the MailerLite dashboard under Settings > Subscriber fields, or via the GET /fields API endpoint.
— — Field Key	string	No	—	The key of the custom field. Find available fields in MailerLite dashboard under Settings > Subscriber fields, or via GET /fields API.
— — Value	string	No	—	The value to set on the custom field. Supports expressions.
— Status	options	No	—	Status of the subscriber.
				Options: active, bounced, junk, unconfirmed, unsubscribed
— Subscribed At	dateTime	No	—	Timestamp when the subscriber was added.
— IP Address	string	No	—	IP address of the subscriber.
— Opted In At	dateTime	No	—	Timestamp when the subscriber opted in.
— Opt In IP	string	No	—	IP address where the subscriber opted in.
— Unsubscribed At	dateTime	No	—	Timestamp when the subscriber unsubscribed.

All Operations

Parameter	Type	Required	Default	Description
Max Concurrency	number	No	10	Maximum number of items to process concurrently.

Output Data

The subscriber record MailerLite returns is merged into the item JSON at the top level — the API’s data envelope is unwrapped for you — so the fields the input item already carried pass through unchanged and binary data is forwarded.

Operation	Output items
create	One item per input item, carrying the created subscriber record
get	One item per input item, carrying the retrieved subscriber record
getAll	Fans out — one output item per subscriber returned. An input item matching nothing yields a single item carrying _empty: true and subscribers: []
update	One item per input item, carrying the updated subscriber record

getAll is the only operation that changes the item count: five subscribers become five items, each a full copy of the input item’s JSON with one subscriber’s fields merged on. Downstream nodes then process subscribers one at a time with no Split Out node in between.

Reference the returned fields directly with {{ $json.… }}; run the node once and inspect an output item to see the exact field names your MailerLite API version returns.

Example Configuration

Create a subscriber with nothing but an email address:

{
  "type": "mailerlite",
  "parameters": {
    "resource": "subscriber",
    "operation": "create",
    "email": "user@example.com"
  }
}

Create a subscriber with metadata and custom fields:

{
  "type": "mailerlite",
  "parameters": {
    "resource": "subscriber",
    "operation": "create",
    "email": "{{ $json.email }}",
    "additionalFields": {
      "status": "active",
      "subscribed_at": "2024-01-01T00:00:00Z",
      "ip_address": "192.168.1.1",
      "customFieldsUi": {
        "customFieldsValues": [
          {
            "fieldId": "first_name",
            "value": "{{ $json.firstName }}"
          },
          {
            "fieldId": "last_name",
            "value": "{{ $json.lastName }}"
          }
        ]
      }
    }
  }
}

Get one subscriber by email address:

{
  "type": "mailerlite",
  "parameters": {
    "resource": "subscriber",
    "operation": "get",
    "subscriberId": "user@example.com"
  }
}

Update a subscriber’s status and a custom field:

{
  "type": "mailerlite",
  "parameters": {
    "resource": "subscriber",
    "operation": "update",
    "subscriberId": "user@example.com",
    "additionalFields": {
      "status": "active",
      "customFieldsUi": {
        "customFieldsValues": [
          {
            "fieldId": "first_name",
            "value": "Jane"
          }
        ]
      }
    }
  }
}

List subscribers, capped at 50:

{
  "type": "mailerlite",
  "parameters": {
    "resource": "subscriber",
    "operation": "getAll",
    "returnAll": false,
    "limit": 50
  }
}

List every active subscriber:

{
  "type": "mailerlite",
  "parameters": {
    "resource": "subscriber",
    "operation": "getAll",
    "returnAll": true,
    "filters": {
      "status": "active"
    }
  }
}

Error Handling

Mode	Behavior
stop	Halts workflow on first error
continue	Skips failed items, passes successful ones through
errorPort	Routes failed items to Error output port

Tips

This tool manages subscribers within the MailerLite email marketing platform. It is ideal for creating, retrieving, listing, or updating individual subscriber records when direct interaction with MailerLite’s subscriber data is needed. The tool produces updated subscriber records, new subscriber entries, or detailed information about existing subscribers.

Pagination Strategy

• For small datasets: Set returnAll to true
• For large datasets: Set returnAll to false and specify a limit
• Always consider using filters to reduce the result set when possible