Update Subscriber
mailerlite.update_subscriber
ActionEmailconnection required
Calls the MailerLite API with the connection's credentials.
Change an existing subscriber's custom fields, groups or subscription status.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- Bearer token
- Providers
- MailerLite
- Secret shape
- the API token, or {"api_key": "…"}
- Config it needs
- base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
4 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
subscriber_id The subscriber's MailerLite id. | string | Yes | — | — | 31982639460318841 |
fields Custom field values to write, keyed by field name. | object | No | — | — | {"name":"Jane"} |
groups The complete set of group ids the subscriber should belong to. | array | No | — | array of string | — |
status The subscription state to set. | string | No | — | one of "active", "unsubscribed", "unconfirmed", "bounced", "junk" | — |
- At least one of fields, groups, status must be set.
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"fields": {
"name": "Jane"
},
"subscriber_id": "31982639460318841"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id MailerLite's id for this subscriber. | string | — |
email The subscriber's email address. | string | — |
status One of active, unsubscribed, unconfirmed, bounced or junk. | string | — |
source How the subscriber entered the account, such as api or import. | string | — |
sent How many campaigns have been sent to this subscriber. | number | — |
opens_count How many of those campaigns the subscriber opened. | number | — |
clicks_count How many links the subscriber has clicked. | number | — |
open_rate Share of sent campaigns opened, as MailerLite reports it. | number | — |
click_rate Share of sent campaigns clicked, as MailerLite reports it. | number | — |
ip_address The IP address the subscription was recorded from. | string | — |
subscribed_at When the subscriber was subscribed, as a MailerLite date. | string | — |
unsubscribed_at When the subscriber unsubscribed, or null. | string | — |
created_at When the subscriber record was created. | string | — |
updated_at When the subscriber record was last changed. | string | — |
fields Custom field values, keyed by the field's name. | object | — |
groups The groups this subscriber belongs to, when they were included. | array | — |
opted_in_at When double opt-in was confirmed, or null. | string | — |
optin_ip The IP address the opt-in was confirmed from, or null. | string | — |
{
"click_rate": 0,
"clicks_count": 0,
"created_at": "",
"email": "",
"fields": {},
"groups": [],
"id": "",
"ip_address": "",
"open_rate": 0,
"opens_count": 0,
"opted_in_at": "",
"optin_ip": "",
"sent": 0,
"source": "",
"status": "",
"subscribed_at": "",
"unsubscribed_at": "",
"updated_at": ""
}Notes
- MailerLite's update endpoint does not accept an email address; to change one, use Create or Update Subscriber instead.
- Groups given here replace the subscriber's memberships — MailerLite removes them from any group the array leaves out. Leave groups empty to keep them.
See Update Subscriber run in a workflow.
In a technical demo we add the MailerLite connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.