Skip to main content
MailerLite logo
  • Category: email newsletters
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 86
  • Triggers: 13
  • Slug: MAILERLITE
  • Version: 20261101_00

Tools

Slug: MAILERLITE_ADD_PRODUCT_TO_CATEGORYTool to add a product to a category in an e-commerce shop. Use when you need to assign or link a product to a specific category for organization and marketing purposes.

Input Parameters

integer
required
The ID of the ecommerce shop.
string
required
The ID of the product to add to the category.
string
required
The ID of the category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_ADD_SUBSCRIBER_TO_GROUPTool to assign an existing subscriber to a group. Use when you need to add a subscriber to a specific group in your MailerLite account.

Input Parameters

string
required
The unique identifier of the group to add the subscriber to.
string
required
The unique identifier of the subscriber to add to the group.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_AUTOMATIONCreate automation

Input Parameters

string
required
Name of the automation workflow.
boolean
Whether to activate the automation upon creation. Defaults to false. Note: automation remains inactive until at least one step or email is added to the workflow, even if set to true at creation.
object
required
Configuration object defining the automation trigger. Must include a type key and a settings object. When trigger type requires a group, settings.group_id must exactly match an id returned by MAILERLITE_GET_GROUPS.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_CAMPAIGNTool to create a new email campaign (draft) with specified type, content, and targeting. Use when you need to create a campaign programmatically with email settings and optional audience targeting via groups or segments. HTML content support is also plan-dependent; insufficient plan capabilities result in can_be_scheduled=false on the created draft.

Input Parameters

string
required
Campaign name (max 255 characters). Used for internal identification.
string ("regular" | "ab" | "resend" | "multivariate")
required
Campaign type: ‘regular’ for standard campaigns, ‘ab’ for A/B tests, ‘resend’ for resend campaigns, ‘multivariate’ for multivariate tests. Note: Availability depends on your MailerLite plan.
array
required
Array of email configurations. Must contain at least one email object with subject, from_name, and from address. Optional reply_to field must be a verified sender address or omitted; unverified addresses return a 422 validation error.
array
Array of group IDs to target with this campaign. If both groups and segments are provided, segments take precedence.
array
Array of segment IDs to target with this campaign. Takes precedence over groups if both are provided.
object
Optional campaign configuration settings.
integer
Language ID for the campaign. Defaults to English if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_ECOMMERCE_CART_ITEMTool to add an item to a shopping cart. Creates the cart if it does not exist. Use for abandoned cart automation.

Input Parameters

number
Unit price of the product. Defaults to 0 if not specified.
string
required
External cart ID. Cart will be created if it does not exist.
string
required
ID of the e-commerce shop.
string
Product variant description (e.g., ‘Color: Blue’, ‘Color black, size medium’).
integer
Quantity of the product. Defaults to 1 if not specified.
integer
required
The MailerLite product ID to add to cart.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_ECOMMERCE_CATEGORYTool to create a new product category for a shop. Use when organizing products into categories or setting up shop taxonomy with automation preferences.

Input Parameters

string
required
The category’s name
string
required
The ID of the shop to create the category for
boolean
If true this category will not trigger any automations. Defaults to false

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_ECOMMERCE_CUSTOMERTool to create or update a customer record for a shop. Use when syncing shop customers or onboarding new purchases.

Input Parameters

string
required
Customer’s email address
string
required
Unique identifier of the e-commerce shop.
number
Total amount the customer has spent in the shop
boolean
True if the customer accepts marketing emails, false otherwise
boolean
If true and no subscriber exists, create a subscriber for the customer

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_ECOMMERCE_ORDERTool to create a new order for a shop. Use when recording customer purchases or syncing order data from external systems.

Input Parameters

object
required
Cart object containing items array with product details
string ("pending" | "complete")
Order status: pending (default) or complete. Use ‘pending’ for initial orders or abandoned carts. Use ‘complete’ to mark orders as completed and trigger purchase automations.
string
required
Unique identifier of the e-commerce shop
object
required
Customer object with email, create_subscriber, and accepts_marketing fields
number
Total order amount. If not provided, defaults to 0

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_ECOMMERCE_PRODUCTTool to create a new product for an e-commerce shop. Use when adding products to a shop for tracking sales, automations, and customer interactions.

Input Parameters

string
Product URL address where customers can view or purchase the product
string
required
Product name
string
Product image URL for the primary product image
number
required
Product price (numeric value, must be non-negative)
string
required
Unique identifier of the e-commerce shop.
string
Product longer description (HTML tags will be removed)
string
Product short description (max 255 characters, HTML will be removed)
boolean
If true, this product will not trigger any automations

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_ECOMMERCE_SHOPTool to connect a new e-commerce shop. Use when you need to integrate a store for automations, product imports, and sales tracking.

Input Parameters

string
required
Shop URL address
string
required
Shop name
boolean
Enable or disable e-commerce features for the shop.
string
required
ISO 4217 currency code that the shop uses (e.g., USD, EUR)
integer
ID of the subscriber group to automatically add shop visitors to.
string
Platform of the shop (e.g., shopify, woocommerce)
string
Platform-specific credentials (e.g., Shopify token or WooCommerce keys).
boolean
Enable popups on the shop (shop must have the universal script).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_FIELDTool to create a new custom field. Use when distinct subscriber attributes are needed before assigning or updating subscriber data. Call once per field key.

Input Parameters

string
required
Name of the custom field (max 255 characters).
string ("text" | "number" | "date")
required
Type of the custom field; one of ‘text’, ‘number’, or ‘date’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_GROUPCreate a subscriber group with the supplied name. The returned group details include its ID.

Input Parameters

string
required
Name of the new subscriber group (max 255 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_SEGMENTCreate a new subscriber segment by name for targeted campaigns.

Input Parameters

string
required
Name of the new subscriber segment (max 255 characters).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_SUBSCRIBERTool to create or update (upsert) a subscriber by email. Use when adding new subscribers or updating existing ones without needing their ID. If subscriber exists, updates non-destructively (omitted fields/groups are preserved).

Input Parameters

string
required
Valid email address as per RFC 2821. Required field.
object
Custom field data (e.g., name, last_name, company, city, country, state, z_i_p, phone). Values are additive; omissions won’t remove existing data.
array
Array of existing group IDs to add subscriber to. Subscriber is only added, not removed by omission.
string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk")
Subscriber status. One of: active, unsubscribed, unconfirmed, bounced, junk. Defaults to ‘active’ if not specified.
string
Valid IP address used during opt-in.
string
Valid IP address of the subscriber.
string
Opt-in date in format: yyyy-MM-dd HH:mm:ss
boolean
Set to true to reactivate previously unsubscribed subscribers.
string
Subscription date in format: yyyy-MM-dd HH:mm:ss
string
Unsubscribe date in format: yyyy-MM-dd HH:mm:ss. Used when status is ‘unsubscribed’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_CREATE_WEBHOOKTool to register a new webhook URL for specified event types. Use when you need real-time notifications for selected MailerLite events.

Input Parameters

string
required
Endpoint URL where webhook notifications will be sent
string
Optional name for the webhook
array
required
List of events to subscribe to; choose from available webhook events
boolean
Whether the webhook is active; defaults to true
boolean
If true, events will be sent in batches. Required for campaign.open and campaign.click events

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_AUTOMATIONTool to delete an automation workflow by ID. Deletion is permanent and irreversible — always require explicit user confirmation before calling. Use when you need to remove an automation after confirming it’s no longer needed. Returns success=True on 204 No Content.

Input Parameters

string
required
Unique identifier of the automation workflow to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_ECOMMERCE_CART_ITEMTool to remove an item from a cart in an e-commerce shop. Use when you need to delete a specific product from a customer’s shopping cart.

Input Parameters

string
required
Unique identifier of the cart.
string
required
Unique identifier of the cart item to delete.
string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_ECOMMERCE_CATEGORYTool to delete a product category from an e-commerce shop by IDs. Use when you need to remove a specific category from your MailerLite store.

Input Parameters

string
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the category to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_ECOMMERCE_CUSTOMERTool to delete a customer from an e-commerce shop by IDs. Use when you need to remove a specific customer from your MailerLite store.

Input Parameters

string
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the customer to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_ECOMMERCE_ORDERDelete an order from a shop by shop and order ID. The response may include deleted order details.

Input Parameters

integer
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the order to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_ECOMMERCE_PRODUCTTool to delete a product from an e-commerce shop by IDs. Use when you need to remove a specific product from your MailerLite store.

Input Parameters

string
required
Unique identifier of the e-commerce shop containing the product.
string
required
Unique identifier of the product to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_ECOMMERCE_SHOPTool to disconnect an e-commerce shop by ID. Use when you have the shop’s unique identifier and want to remove it from your MailerLite account.

Input Parameters

string
required
Unique identifier of the e-commerce shop to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_FIELDTool to delete a custom field. Use when a field is obsolete and you need to remove it from your MailerLite account. Returns success=True on 204 No Content.

Input Parameters

string
required
Unique identifier of the custom field to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_GROUPTool to delete a subscriber group by ID. Permanently removes the group and all its subscriber associations — irreversible with no undo. Use when you need to remove an existing subscriber group from your MailerLite account. Require explicit user confirmation before invoking. Returns success=True on 204 No Content.

Input Parameters

string
required
The unique identifier of the group to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_SEGMENTTool to delete a segment by ID. Use when you need to remove an existing segment from your MailerLite account. Returns success=True on 204 No Content.

Input Parameters

string
required
The unique identifier of the segment to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_SUBSCRIBERTool to delete a subscriber by ID. Use when you have the subscriber ID and want to remove them from your MailerLite account. Returns success=True on 204 No Content.

Input Parameters

string
required
The unique identifier of the subscriber to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_DELETE_WEBHOOKTool to remove a webhook subscription by ID. Use when you need to delete a webhook after confirming it is no longer needed. Returns success=True on 204 No Content.

Input Parameters

string
required
Unique identifier of the webhook to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_EXECUTE_BATCH_REQUESTTool to execute multiple API requests in a single batch call (max 50 requests). Use when you need to perform multiple operations efficiently or reduce API call overhead. Note: Individual request failures don’t stop batch processing; check each response code. Webhooks are not supported in batch requests.

Input Parameters

array
required
Array of API requests to execute in batch. Maximum 50 requests allowed. Each request must include method and path; body is optional for POST/PUT/PATCH methods.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_FORGET_SUBSCRIBERTool to forget a subscriber completely (GDPR compliant deletion). Use when you need to permanently delete all subscriber data within 30 days.

Input Parameters

string
required
The unique identifier of the subscriber to forget. Data will be completely deleted in 30 days.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ACCOUNT_INFORetrieve basic MailerLite account details to review account metadata and verify authentication. The returned account fields include identity, timezone, roles, and plan information; absent domain fields do not establish sender-domain verification status.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ACCOUNT_STATSTool to retrieve usage statistics and performance metrics for the account. Use after sending campaigns to analyze engagement and deliverability.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_AUTOMATIONTool to retrieve details of a specific automation by ID. Use when you have the automation ID and need its full configuration. Example: “Get automation 7267552”.

Input Parameters

string
Comma-separated list of fields to include in the response
string
required
Unique identifier of the automation to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_AUTOMATION_ACTIVITYTool to retrieve subscriber activity for a specific automation. Use when you need to track automation execution status and subscriber progress through workflows. Requires filter[status] parameter to be specified.

Input Parameters

string
required
Unique identifier of the automation to retrieve activity for
string ("completed" | "active" | "canceled" | "failed")
required
Filter by activity status. REQUIRED parameter - must be one of: completed, active, canceled, failed

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_CAMPAIGN_LANGUAGESTool to retrieve a list of all available campaign languages. Use when you need to fetch supported languages for creating or configuring campaigns.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_CAMPAIGNSTool to retrieve a list of all campaigns. Use when you need to fetch campaigns optionally filtered by status or type, with pagination.

Input Parameters

integer
Page number (min 1). Defaults to server default (1). Use with limit and check meta.last_page in the response to determine when pagination is complete.
string ("regular" | "ab" | "resend" | "rss")
Filter campaigns by type: ‘regular’, ‘ab’, ‘resend’, or ‘rss’.
integer
Items per page (min 1). Defaults to server default (25). Only specific discrete values are accepted; arbitrary integers trigger a 422 ‘The selected limit is invalid’ error. Use the default (25) if unsure.
string ("sent" | "draft" | "ready")
Filter campaigns by status: ‘sent’, ‘draft’, or ‘ready’.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_CARTTool to fetch details of a specific cart by shop ID and cart ID. Use when you need to retrieve cart information including customer, items, total, and checkout URL.

Input Parameters

string
required
Unique identifier of the cart to retrieve.
string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_CART_ITEMTool to fetch details of a specific cart item by shop ID, cart ID, and item ID. Use when you need to retrieve information about a specific item in a cart.

Input Parameters

string
required
Unique identifier of the cart.
string
required
Unique identifier of the cart item to retrieve.
string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_CATEGORYTool to fetch details of a specific product category by shop and category ID. Use when you need information about a specific e-commerce category.

Input Parameters

string
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the product category to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_CUSTOMERTool to fetch details of a customer by shop and customer ID. Use after confirming shop_id and customer_id.

Input Parameters

string
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the customer within the shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_CUSTOMERSTool to list customers for a specific shop. Use when you need to retrieve and paginate ecommerce customers after you have a shop ID. Example: “List customers for shop 123”.

Input Parameters

integer
Page number to retrieve. Defaults to 1 if not provided.
integer
Number of customers per page. Defaults to server-side default if not provided.
string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_ORDERTool to fetch details of a specific e-commerce order by shop ID and order ID. Use when you need to retrieve order information including customer, cart items, total, and status.

Input Parameters

string
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the order to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_PRODUCTTool to fetch details of a specific e-commerce product by shop and product ID. Use when you need product information such as name, price, description, and categories.

Input Parameters

string
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the product to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_SHOPTool to fetch details of a specific e-commerce shop by ID. Use when you need detailed configuration or stats of a connected shop.

Input Parameters

string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_ECOMMERCE_SHOPSTool to list all e-commerce shops connected to the account. Use when you need to retrieve and paginate shop listings for an account.

Input Parameters

integer
Page number to retrieve. Defaults to 1 if not provided.
integer
Number of items per page. Defaults to 50 if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_FIELDSTool to retrieve all custom fields defined in the account. Use when you need to list or paginate through subscriber custom fields.

Input Parameters

integer
Page number to retrieve.
string ("name" | "type" | "-name" | "-type")
Sort fields by ‘name’ or ‘type’; prepend with ’-’ for descending order.
integer
Maximum number of fields to return.
string ("text" | "number" | "date")
Filter fields by type; one of ‘text’, ‘number’, ‘date’.
string
Filter fields by keyword (matches name or key).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_GROUPTool to retrieve details of a specific subscriber group by ID. Use when you need information about a particular group’s statistics and configuration.

Input Parameters

string
required
The unique identifier of the group to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_GROUPSTool to retrieve all subscriber groups. Use when listing, paginating, or looking up group IDs for use in downstream tools (e.g., trigger.settings.group_id). Always verify returned IDs exactly match before passing to other tools; mismatched IDs cause silent failures.

Input Parameters

integer
Page number to retrieve (starting from 1). Increment page until an empty result set is returned to retrieve all groups.
string ("name" | "total" | "open_rate" | "click_rate" | "created_at" | "-name" | "-total" | "-open_rate" | "-click_rate" | "-created_at")
Sort results by field. Prepend with ’-’ for descending order.
integer
Maximum number of groups to return.
string
Filter groups by name; returns partial matches. May return multiple results; verify the correct group by checking the full name or ID rather than assuming the first result is correct.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_GROUP_SUBSCRIBERSTool to list subscribers within a group by ID. Use when you need to retrieve subscribers belonging to a specific MailerLite group before targeted campaigns. Use after confirming the group ID is valid.

Input Parameters

integer
Number of subscribers to return per page.
string
Cursor token for pagination (from meta.next_cursor).
string
Include additional resources. Currently only ‘groups’.
string
required
Unique identifier of the group.
string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk")
Filter subscribers by status: active, unsubscribed, unconfirmed, bounced, or junk.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_IMPORT_STATUSTool to retrieve the status and detailed report of a subscriber import operation by import ID. Use after initiating an import to track progress and review results including validation issues, duplicates, and processing statistics.

Input Parameters

string
required
The unique identifier of the subscriber import operation obtained from POST /groups/{group_id}/import-subscribers

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_SEGMENTTool to retrieve a specific segment by ID. Use when you need to get details about a particular segment including subscriber count, open rate, and click rate statistics.

Input Parameters

string
required
The unique ID of the segment to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_SEGMENTSTool to retrieve all segments in the account. Use when you need to list or paginate through segments.

Input Parameters

integer
Page number to retrieve (starting from 1)
integer
Maximum number of segments to return (max 250)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_SEGMENT_SUBSCRIBERSTool to retrieve all subscribers belonging to a specific segment. Use when you need to list or paginate through subscribers in a MailerLite segment for targeted campaigns or analysis.

Input Parameters

string
Cursor token for pagination (from meta.next_cursor in previous response).
integer
Number of subscribers to return per page (default 25).
string
required
Unique identifier of the segment to get subscribers from.
string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk")
Filter subscribers by status: active, unsubscribed, unconfirmed, bounced, or junk.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_SUBSCRIBERTool to fetch a single subscriber by ID or email address. Use when you need to retrieve detailed information about a specific subscriber.

Input Parameters

string
required
The subscriber ID (numeric string) or email address to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_SUBSCRIBER_ACTIVITYTool to fetch the activity log for a specific subscriber. Use when you need to track subscriber engagement history including email opens, link clicks, bounces, and other events.

Input Parameters

integer
Number of activity log entries to return per page. Default: 25, Maximum: 100.
string
Pagination cursor for fetching the next page of results. Obtained from the previous response’s pagination metadata.
string
Filter activity log by type. Common types include: email_open, link_click, bounce, unsubscribe, added_to_group, activated. Leave empty to fetch all activity types.
string
required
The unique identifier of the subscriber to fetch activity log for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_SUBSCRIBERSTool to retrieve all subscribers. Use after connecting account and when listing subscribers by status or paginating. Response payload nested under results[i].response.data with data and meta subkeys. Paginate all pages before computing metrics to avoid sampling bias. Limited by MailerLite Connect API quotas.

Input Parameters

integer
Number of subscribers per page. Defaults to server default (usually 25).
string
Pagination cursor for next page (from previous response meta.cursor). Use value from meta.next_cursor (not meta.cursor); continue until meta.next_cursor is null — stopping early may cause subscribers to appear missing.
string
Include additional resources. Currently only ‘groups’. Subscribers removed from all groups return an empty groups array; do not assume every subscriber belongs to at least one group.
string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk")
Filter subscribers by status: active, unsubscribed, unconfirmed, bounced, or junk.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_SUBSCRIBERS_STATSTool to get subscriber statistics for the account. Use to retrieve counts of total, active, unsubscribed, unconfirmed, bounced, and junk subscribers.

Input Parameters

string
Locale for the response (e.g., ‘en’, ‘pl’). If not provided, defaults to account’s default locale.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_WEBHOOKTool to retrieve details of a specific webhook by ID. Use when you need to get information about a particular webhook configuration.

Input Parameters

string
required
Unique identifier of the webhook to retrieve.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_GET_WEBHOOKSList configured webhooks for a MailerLite account, with page and limit parameters and pagination metadata when provided.

Input Parameters

integer
Page number for pagination. Defaults to 1 if not provided.
integer
Number of webhooks to return per page. Defaults to 50 if not provided.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_IMPORT_ECOMMERCE_CATEGORIESTool to bulk import categories to an e-commerce shop. Use when you need to add multiple categories at once to a shop.

Input Parameters

string
required
Unique identifier of the e-commerce shop.
array
required
Array of category objects to import. Each category must have a name.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_IMPORT_ECOMMERCE_ORDERSTool to bulk import orders to an e-commerce shop. Use when syncing historical orders or bulk loading order data. Products must exist before importing orders.

Input Parameters

array
required
Array of order objects to import. Must contain at least one order.
integer
required
Unique identifier of the e-commerce shop to import orders into.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_IMPORT_ECOMMERCE_PRODUCTSTool to bulk import products to an e-commerce shop. Use when you need to add multiple products to a shop in one request.

Input Parameters

integer
required
ID of the e-commerce shop.
array
required
Array of product objects to import (at least one required).

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_IMPORT_SUBSCRIBERS_TO_GROUPTool to bulk import multiple subscribers to a specific group. Use when adding many subscribers at once is more efficient than individual creation. The import runs asynchronously by default; use the returned progress URL to check completion status.

Input Parameters

string
required
Unique identifier of the group to import subscribers to.
boolean
Set to true to reactivate previously unsubscribed subscribers.
array
required
Array of subscriber objects to import. Each object must contain an email and optionally a fields object with custom field data.
boolean
If true, run import synchronously and return status immediately instead of a progress URL. Use for small batches when immediate results are needed.
boolean
Set to true to trigger autoresponders for imported subscribers.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_AUTOMATIONSTool to retrieve all automations in your MailerLite account. Use when you need to list automations, optionally filtered by status, name, or group. Supports pagination for large result sets.

Input Parameters

integer
Page number for pagination, starting from 1. Defaults to 1 if not specified.
integer
Number of automations to return per page. Defaults to 10 if not specified.
string
Filter automations by name. Returns automations matching the specified name.
string
Filter by group ID. Returns all automations that use the specified group in their trigger configuration.
boolean
Filter by automation status - true for active automations, false for inactive automations. If not specified, returns all automations.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_ECOMMERCE_CART_ITEMSList items in a specific e-commerce shop cart by shop and cart ID. Results are paginated.

Input Parameters

integer
Page number to retrieve. Defaults to 1 if not provided.
integer
Number of items per page. Defaults to 100 if not provided.
string
required
Unique identifier of the cart.
string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_ECOMMERCE_CARTSList carts for a specific shop, including abandoned or active shopping carts. Results are paginated.

Input Parameters

integer
Page number to retrieve. Defaults to 1 if not provided.
integer
Number of carts per page. Defaults to 100 if not provided.
string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_ECOMMERCE_CATEGORIESTool to list all product categories for a shop. Use when you need to retrieve or paginate through categories.

Input Parameters

integer
Page number for pagination (starting from 1).
integer
Number of records per page.
integer
required
The ID of the shop to list categories for.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_ECOMMERCE_CATEGORY_PRODUCTSList products in a specific e-commerce category for a given shop and category. Results are paginated.

Input Parameters

integer
Page number to retrieve. Defaults to 1 if not provided.
integer
Maximum number of products per page. Defaults to 100 if not provided.
integer
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the category.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_ECOMMERCE_ORDERSTool to list all orders for a specific e-commerce shop. Use when you need to retrieve and paginate orders for a shop after you have a shop ID.

Input Parameters

integer
Page number to retrieve. Defaults to 1 if not provided.
integer
Number of orders per page. Defaults to 100 if not provided.
string
required
Unique identifier of the e-commerce shop.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_ECOMMERCE_PRODUCTSTool to list all products for a specific e-commerce shop. Use when you need to retrieve and paginate product listings after you have a shop ID.

Input Parameters

integer
Page number for pagination. Defaults to 1 if not provided.
integer
Number of results per page. Defaults to 100 if not provided.
integer
required
Unique identifier of the e-commerce shop. Must provide valid shop id.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_FORMSTool to retrieve all forms of a specific type (popup, embedded, or promotion). Use when you need to list forms with optional filtering by name and pagination support.

Input Parameters

integer
Page number to retrieve (starting from 1).
string
Sort options: created_at, name, conversions_count, opens_count, visitors, conversion_rate, last_registration_at. Prepend ’-’ for descending order.
string ("popup" | "embedded" | "promotion")
required
Type of forms to list: ‘popup’, ‘embedded’, or ‘promotion’.
integer
Maximum number of forms to return per page.
string
Filter forms by name; returns partial matches.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_LIST_TIMEZONESTool to retrieve all available timezones supported by MailerLite. Use when you need to get timezone options for campaigns, automations, or scheduling.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_REMOVE_PRODUCT_FROM_CATEGORYTool to remove a product from a category in an e-commerce shop. Use when you need to unlink a product from a specific category without deleting the product itself.

Input Parameters

integer
required
Unique identifier of the e-commerce shop.
string
required
Unique identifier of the product to remove from the category.
string
required
Unique identifier of the category to remove the product from.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_REMOVE_SUBSCRIBER_FROM_GROUPTool to remove a subscriber from a group by ID. Use when you need to unassign a subscriber from a specific group in your MailerLite account. Returns success=True on 204 No Content.

Input Parameters

string
required
The unique identifier of the group to remove the subscriber from.
string
required
The unique identifier of the subscriber to remove from the group.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_SET_DOUBLE_OPTINTool to enable or disable double opt-in for new subscribers. Use when configuring subscription confirmation settings.

Input Parameters

boolean
required
Enable double opt-in for new subscribers if True, disable if False.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_ECOMMERCE_CARTUpdate an existing e-commerce cart’s checkout URL or total price by shop ID and cart ID.

Input Parameters

string
required
Unique identifier of the cart to update.
string
required
Unique identifier of the e-commerce shop.
number
The cart’s total price in the shop’s currency. Defaults to 0 if not provided.
string
The cart’s checkout URL where customers can complete their purchase.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_ECOMMERCE_CART_ITEMTool to update a cart item’s quantity or properties in an e-commerce cart. Use when you need to modify an existing item in a customer’s cart.

Input Parameters

number
Price of the cart item. Defaults to 0 if not provided.
string
required
Unique identifier of the cart.
string
required
Unique identifier of the cart item to update.
string
required
Unique identifier of the e-commerce shop.
string
The product’s variant information (e.g., ‘Color red, size large’).
integer
Quantity of the product in the cart. Defaults to 1 if not provided.
integer
required
The ID of the product associated with this cart item.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_ECOMMERCE_CATEGORYTool to update an existing product category in an e-commerce shop. Use when you need to modify the category name or automation settings.

Input Parameters

string
required
The category’s name
string
required
Valid shop identifier
string
required
Valid category identifier
boolean
When true, the category won’t trigger automations; defaults to false

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_ECOMMERCE_CUSTOMERTool to update a customer’s data for a shop by IDs. Use when you need to change email, marketing opt-in, or spend totals for an existing customer.

Input Parameters

string
required
Valid email address of the customer.
string
required
ID of the e-commerce shop.
string
required
ID of the customer to update.
number
Total amount the customer has spent in the shop.
boolean
True if the customer accepts marketing emails.
boolean
If true, creates or associates a subscriber for this customer.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_ECOMMERCE_ORDERTool to update an existing order’s status or total price in an e-commerce shop. Use when you need to mark orders as complete or adjust pricing. Note: Cannot update cart or customer through this endpoint.

Input Parameters

string ("pending" | "complete")
Enum for order status values.
string
required
ID of the e-commerce shop containing the order.
string
required
ID of the order to update.
number
The order’s total price. Must be non-negative.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_ECOMMERCE_PRODUCTTool to update an existing product in an e-commerce shop by IDs. Use when you need to modify product details like name, price, description, or URL.

Input Parameters

string
Product URL address.
string
required
Product name.
string
Main product image URL.
number
Price in shop currency; defaults to 0 if not provided.
string
required
Unique identifier of the e-commerce shop containing the product.
string
required
Unique identifier of the product to update.
string
Full product description. HTML tags are automatically removed.
string
Short product description (max 255 characters). HTML tags are automatically removed.
boolean
If true, prevents this product from triggering automations; defaults to false.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_ECOMMERCE_SHOPTool to update settings of a connected e-commerce shop by ID. Use when you need to modify shop details (name, URL, currency) or toggle features after verifying the shop exists.

Input Parameters

string
required
Shop URL address
string
required
Shop name
boolean
Enable e-commerce functionality for the shop; defaults to false
string
required
ID of the e-commerce shop to update
string
required
ISO 4217 currency code that the shop uses
integer
ID of the group that shop subscribers are automatically added to
string
E-commerce platform of the shop (e.g., Shopify)
string
Platform-specific access credential for the shop
boolean
Enable popups for the shop; defaults to false

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_FIELDTool to update the title of an existing custom field. Use when renaming a field label (e.g., correct typos or rebranding).

Input Parameters

string
required
New name for the custom field (max 255 characters)
string
required
ID of the custom field to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_GROUPTool to update a group’s name by ID. Use when renaming an existing group after confirming its ID. Note: renaming does not update references in downstream integrations or reports that use the old group name.

Input Parameters

string
required
Group’s unique identifier
string
required
New name for the group (max 255 characters)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_SEGMENTTool to rename an existing segment by ID. Use when you need to update a segment’s name after confirming its ID.

Input Parameters

string
required
Segment’s unique identifier
string
required
New name for the segment (max 255 characters)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_SUBSCRIBERTool to update an existing subscriber’s information by ID. Use when altering subscriber details.

Input Parameters

string
required
Subscriber’s unique identifier
object
Mapping of field names to values; omissions do not remove fields.
array
List of group IDs to assign; subscriber will be removed from others.
string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk")
Subscriber status.
string
IP address used when subscriber opted in.
string
IP address for subscription record.
string
Opt-in timestamp in ‘YYYY-MM-DD HH:MM:SS’ format.
string
Custom subscription timestamp in ‘YYYY-MM-DD HH:MM:SS’ format.
string
Unsubscription timestamp in ‘YYYY-MM-DD HH:MM:SS’ format.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILERLITE_UPDATE_WEBHOOKUpdate a MailerLite webhook by ID, supplying its URL and event triggers. The name, enabled status, and batching setting can also be updated.

Input Parameters

string
required
Endpoint URL where webhook notifications will be sent
string
Optional new name for the webhook
array
required
List of events to subscribe to; choose from available webhook events
boolean
Whether the webhook should be active; defaults to current setting
boolean
Whether the webhook should use batched deliveries
string
required
ID of the webhook to update

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not

Triggers

Slug: MAILERLITE_CAMPAIGN_OPENEDType: webhookTriggers when a subscriber opens one of the account’s campaigns, once per open.Opens are counted with a tracking pixel, so mailboxes that block or pre-fetch images make the count unreliable.

Configuration

string
Only fire for this campaign. Use MAILERLITE_GET_CAMPAIGNS to find the campaign id. Leave unset to fire for every campaign on the account, which for opens and clicks is a high volume of events.

Payload

object
required
The campaign that was opened.
object
required
The subscriber that opened the campaign.
Slug: MAILERLITE_CAMPAIGN_SENTType: webhookTriggers when a campaign finishes sending to its audience, once per campaign rather than once per recipient.

Payload

string
required
When the campaign was sent.
string
required
MailerLite’s id for the campaign. List the account’s campaigns with MAILERLITE_GET_CAMPAIGNS.
string
required
The campaign’s name.
string
required
Public URL to preview the campaign’s rendered content.
integer
required
How many subscribers the campaign was sent to.
Slug: MAILERLITE_SUBSCRIBER_ADDED_TO_GROUPType: webhookTriggers when a subscriber is added to one of the account’s groups.Membership changes made through MailerLite’s API have been observed not to trigger it, only ones made through a form, a landing page or the MailerLite app.

Configuration

string
Only fire for this group. Use MAILERLITE_GET_GROUPS to find the group id. Leave unset to fire for every group on the account.

Payload

object
required
The group the subscriber was added to.
object
required
The subscriber that joined the group.
Slug: MAILERLITE_SUBSCRIBER_BOUNCEDType: webhookTriggers when an email MailerLite sent to a subscriber bounces: a real delivery failure reported back by the receiving mailbox, not a status set through the API.

Payload

number
required
Click rate for this subscriber, 0..1.
integer
required
Count of campaign link clicks by this subscriber.
string
required
When the subscriber record was created.
string
When the subscriber was deleted; null on a live subscriber.
string
required
The subscriber’s email address.
object
required
The account’s custom fields for this subscriber. An open map: keys are whatever custom fields the account defines, values are string, number, date or null. List the definitions with MAILERLITE_GET_FIELDS.
string
When the subscriber’s data is scheduled to be erased under MailerLite’s forget path; null otherwise.
string
required
MailerLite’s id for the subscriber, a numeric string. Read the full record with MAILERLITE_GET_SUBSCRIBER.
string
IP the subscriber signed up from. Null for API-created subscribers; populated for web-form signups.
object
Geo-IP location resolved at signup: id, title, country_name, continent_name, state_name, time_zone. Null for every API-created subscriber; populated for web-form signups.
number
required
Open rate for this subscriber, 0..1.
integer
required
Count of campaign opens by this subscriber.
string
When the subscriber confirmed a double opt-in; null when the account does not use double opt-in.
string
IP the double opt-in was confirmed from; null when unused.
integer
required
Count of campaigns sent to this subscriber.
string
required
How the subscriber entered the account. Five values observed live: api, webform, ecommerce, import, manual. MailerLite documents no enum.
string
required
Current subscriber status. MailerLite documents the set as active, unsubscribed, unconfirmed, bounced, junk.
string
required
When the subscriber subscribed.
string
When the subscriber unsubscribed; null until they do.
string
required
When the subscriber record last changed. Equal to created_at on a fresh create, which is the cheap way to drop the duplicate Subscriber Updated that a create with fields also emits.
Slug: MAILERLITE_SUBSCRIBER_COMPLETED_AUTOMATIONType: webhookTriggers when a subscriber reaches the end of one of the account’s automations.Subscriber Entered Automation triggers when they start one.

Configuration

string
Only fire for this automation. Use MAILERLITE_LIST_AUTOMATIONS to find the automation id. Leave unset to fire for every automation on the account.

Payload

object
required
The automation the subscriber completed.
object
required
The subscriber that finished the automation.
Slug: MAILERLITE_SUBSCRIBER_CREATEDType: webhookTriggers when a subscriber is added to the account through any origin: the API, an import, a signup form, a landing page or the MailerLite app.Creating a subscriber with custom fields in the same call also triggers Subscriber Updated for them.

Configuration

array
Only fire for subscribers that arrived this way, e.g. ['webform'] to skip the ones your own integration writes. MailerLite sets the origin itself and documents no fixed list; the values seen in practice are api, webform, ecommerce, import, manual and subscribe app. Leave unset to fire for every origin.
array
Only fire for subscribers created in these states, e.g. ['active'] to skip the ones still to confirm a double opt-in. One or more of active, unconfirmed, unsubscribed, bounced, junk. Leave unset to fire for every state.

Payload

number
required
Click rate for this subscriber, 0..1.
integer
required
Count of campaign link clicks by this subscriber.
string
required
When the subscriber record was created.
string
When the subscriber was deleted; null on a live subscriber.
string
required
The subscriber’s email address.
object
required
The account’s custom fields for this subscriber. An open map: keys are whatever custom fields the account defines, values are string, number, date or null. List the definitions with MAILERLITE_GET_FIELDS.
string
When the subscriber’s data is scheduled to be erased under MailerLite’s forget path; null otherwise.
string
required
MailerLite’s id for the subscriber, a numeric string. Read the full record with MAILERLITE_GET_SUBSCRIBER.
string
IP the subscriber signed up from. Null for API-created subscribers; populated for web-form signups.
object
Geo-IP location resolved at signup: id, title, country_name, continent_name, state_name, time_zone. Null for every API-created subscriber; populated for web-form signups.
number
required
Open rate for this subscriber, 0..1.
integer
required
Count of campaign opens by this subscriber.
string
When the subscriber confirmed a double opt-in; null when the account does not use double opt-in.
string
IP the double opt-in was confirmed from; null when unused.
integer
required
Count of campaigns sent to this subscriber.
string
required
How the subscriber entered the account. Five values observed live: api, webform, ecommerce, import, manual. MailerLite documents no enum.
string
required
Current subscriber status. MailerLite documents the set as active, unsubscribed, unconfirmed, bounced, junk.
string
required
When the subscriber subscribed.
string
When the subscriber unsubscribed; null until they do.
string
required
When the subscriber record last changed. Equal to created_at on a fresh create, which is the cheap way to drop the duplicate Subscriber Updated that a create with fields also emits.
Slug: MAILERLITE_SUBSCRIBER_DELETEDType: webhookTriggers when a subscriber is deleted, or their data is erased through MailerLite’s forget path.The payload still carries the email address and custom fields being erased.

Payload

object
required
The subscriber as they stood when they were removed, still carrying the email address and custom fields being erased.
Slug: MAILERLITE_SUBSCRIBER_ENTERED_AUTOMATIONType: webhookTriggers when a subscriber enters one of the account’s automations.Subscriber Completed Automation triggers when they reach the end of one.

Configuration

string
Only fire for this automation. Use MAILERLITE_LIST_AUTOMATIONS to find the automation id. Leave unset to fire for every automation on the account.

Payload

object
required
The automation the subscriber entered.
object
required
The subscriber that entered the automation.
Slug: MAILERLITE_SUBSCRIBER_REMOVED_FROM_GROUPType: webhookTriggers when a subscriber is removed from one of the account’s groups.Membership changes made through MailerLite’s API have been observed not to trigger it, only ones made through a form, a landing page or the MailerLite app.

Configuration

string
Only fire for this group. Use MAILERLITE_GET_GROUPS to find the group id. Leave unset to fire for every group on the account.

Payload

object
required
The group the subscriber was removed from.
object
required
The subscriber that left the group.
Slug: MAILERLITE_SUBSCRIBER_REPORTED_SPAMType: webhookTriggers when a subscriber marks one of the account’s campaigns as spam: a complaint fed back by the receiving mailbox, not a status set through the API.

Payload

number
required
Click rate for this subscriber, 0..1.
integer
required
Count of campaign link clicks by this subscriber.
string
required
When the subscriber record was created.
string
When the subscriber was deleted; null on a live subscriber.
string
required
The subscriber’s email address.
object
required
The account’s custom fields for this subscriber. An open map: keys are whatever custom fields the account defines, values are string, number, date or null. List the definitions with MAILERLITE_GET_FIELDS.
string
When the subscriber’s data is scheduled to be erased under MailerLite’s forget path; null otherwise.
string
required
MailerLite’s id for the subscriber, a numeric string. Read the full record with MAILERLITE_GET_SUBSCRIBER.
string
IP the subscriber signed up from. Null for API-created subscribers; populated for web-form signups.
object
Geo-IP location resolved at signup: id, title, country_name, continent_name, state_name, time_zone. Null for every API-created subscriber; populated for web-form signups.
number
required
Open rate for this subscriber, 0..1.
integer
required
Count of campaign opens by this subscriber.
string
When the subscriber confirmed a double opt-in; null when the account does not use double opt-in.
string
IP the double opt-in was confirmed from; null when unused.
integer
required
Count of campaigns sent to this subscriber.
string
required
How the subscriber entered the account. Five values observed live: api, webform, ecommerce, import, manual. MailerLite documents no enum.
string
required
Current subscriber status. MailerLite documents the set as active, unsubscribed, unconfirmed, bounced, junk.
string
required
When the subscriber subscribed.
string
When the subscriber unsubscribed; null until they do.
string
required
When the subscriber record last changed. Equal to created_at on a fresh create, which is the cheap way to drop the duplicate Subscriber Updated that a create with fields also emits.
Slug: MAILERLITE_SUBSCRIBER_UNSUBSCRIBEDType: webhookTriggers when a subscriber opts out of the account’s mailings.MailerLite sends this instead of Subscriber Updated, so it is the only trigger that sees an opt-out.

Payload

number
required
Click rate for this subscriber, 0..1.
integer
required
Count of campaign link clicks by this subscriber.
string
required
When the subscriber record was created.
string
When the subscriber was deleted; null on a live subscriber.
string
required
The subscriber’s email address.
object
required
The account’s custom fields for this subscriber. An open map: keys are whatever custom fields the account defines, values are string, number, date or null. List the definitions with MAILERLITE_GET_FIELDS.
string
When the subscriber’s data is scheduled to be erased under MailerLite’s forget path; null otherwise.
string
required
MailerLite’s id for the subscriber, a numeric string. Read the full record with MAILERLITE_GET_SUBSCRIBER.
string
IP the subscriber signed up from. Null for API-created subscribers; populated for web-form signups.
object
Geo-IP location resolved at signup: id, title, country_name, continent_name, state_name, time_zone. Null for every API-created subscriber; populated for web-form signups.
number
required
Open rate for this subscriber, 0..1.
integer
required
Count of campaign opens by this subscriber.
string
When the subscriber confirmed a double opt-in; null when the account does not use double opt-in.
string
IP the double opt-in was confirmed from; null when unused.
integer
required
Count of campaigns sent to this subscriber.
string
required
How the subscriber entered the account. Five values observed live: api, webform, ecommerce, import, manual. MailerLite documents no enum.
string
required
Current subscriber status. MailerLite documents the set as active, unsubscribed, unconfirmed, bounced, junk.
string
required
When the subscriber subscribed.
string
When the subscriber unsubscribed; null until they do.
string
required
When the subscriber record last changed. Equal to created_at on a fresh create, which is the cheap way to drop the duplicate Subscriber Updated that a create with fields also emits.
Slug: MAILERLITE_SUBSCRIBER_UPDATEDType: webhookTriggers when a subscriber’s custom fields are written, or when they confirm a double opt-in.Group changes, bounces, spam reports, deletions and opt-outs each have their own trigger and do not trigger this one.

Configuration

array
Only fire for subscribers that arrived this way, e.g. ['webform'] to skip the ones your own integration writes. MailerLite sets the origin itself and documents no fixed list; the values seen in practice are api, webform, ecommerce, import, manual and subscribe app. Leave unset to fire for every origin.

Payload

number
required
Click rate for this subscriber, 0..1.
integer
required
Count of campaign link clicks by this subscriber.
string
required
When the subscriber record was created.
string
When the subscriber was deleted; null on a live subscriber.
string
required
The subscriber’s email address.
object
required
The account’s custom fields for this subscriber. An open map: keys are whatever custom fields the account defines, values are string, number, date or null. List the definitions with MAILERLITE_GET_FIELDS.
string
When the subscriber’s data is scheduled to be erased under MailerLite’s forget path; null otherwise.
string
required
MailerLite’s id for the subscriber, a numeric string. Read the full record with MAILERLITE_GET_SUBSCRIBER.
string
IP the subscriber signed up from. Null for API-created subscribers; populated for web-form signups.
object
Geo-IP location resolved at signup: id, title, country_name, continent_name, state_name, time_zone. Null for every API-created subscriber; populated for web-form signups.
number
required
Open rate for this subscriber, 0..1.
integer
required
Count of campaign opens by this subscriber.
string
When the subscriber confirmed a double opt-in; null when the account does not use double opt-in.
string
IP the double opt-in was confirmed from; null when unused.
integer
required
Count of campaigns sent to this subscriber.
string
required
How the subscriber entered the account. Five values observed live: api, webform, ecommerce, import, manual. MailerLite documents no enum.
string
required
Current subscriber status. MailerLite documents the set as active, unsubscribed, unconfirmed, bounced, junk.
string
required
When the subscriber subscribed.
string
When the subscriber unsubscribed; null until they do.
string
required
When the subscriber record last changed. Equal to created_at on a fresh create, which is the cheap way to drop the duplicate Subscriber Updated that a create with fields also emits.