# MailerLite

MailerLite is an email marketing service that offers tools for creating and managing email campaigns, automating workflows, and building landing pages.

- **Category:** email newsletters
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 86
- **Triggers:** 0
- **Slug:** `MAILERLITE`
- **Version:** 20260316_00

## Tools

### Add Product to Category

**Slug:** `MAILERLITE_ADD_PRODUCT_TO_CATEGORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | integer | Yes | The ID of the ecommerce shop. |
| `product_id` | integer | Yes | The ID of the product to add to the category. |
| `category_id` | integer | Yes | The ID of the category. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add Subscriber To Group

**Slug:** `MAILERLITE_ADD_SUBSCRIBER_TO_GROUP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the group to add the subscriber to. |
| `subscriber_id` | string | Yes | The unique identifier of the subscriber to add to the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create automation

**Slug:** `MAILERLITE_CREATE_AUTOMATION`

Create automation

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the automation workflow. |
| `enabled` | boolean | No | 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. |
| `trigger` | object | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Campaign

**Slug:** `MAILERLITE_CREATE_CAMPAIGN`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Campaign name (max 255 characters). Used for internal identification. |
| `type` | string ("regular" | "ab" | "resend" | "multivariate") | Yes | 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. |
| `emails` | array | Yes | 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. |
| `groups` | array | No | Array of group IDs to target with this campaign. If both groups and segments are provided, segments take precedence. |
| `segments` | array | No | Array of segment IDs to target with this campaign. Takes precedence over groups if both are provided. |
| `settings` | object | No | Optional campaign configuration settings. |
| `language_id` | integer | No | Language ID for the campaign. Defaults to English if not specified. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create E-commerce Cart Item

**Slug:** `MAILERLITE_CREATE_ECOMMERCE_CART_ITEM`

Tool to add an item to a shopping cart. Creates the cart if it does not exist. Use for abandoned cart automation.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `price` | number | No | Unit price of the product. Defaults to 0 if not specified. |
| `cart_id` | string | Yes | External cart ID. Cart will be created if it does not exist. |
| `shop_id` | string | Yes | ID of the e-commerce shop. |
| `variant` | string | No | Product variant description (e.g., 'Color: Blue', 'Color black, size medium'). |
| `quantity` | integer | No | Quantity of the product. Defaults to 1 if not specified. |
| `ecommerce_product_id` | integer | Yes | The MailerLite product ID to add to cart. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create E-commerce Category

**Slug:** `MAILERLITE_CREATE_ECOMMERCE_CATEGORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The category's name |
| `shop_id` | string | Yes | The ID of the shop to create the category for |
| `exclude_from_automations` | boolean | No | If true this category will not trigger any automations. Defaults to false |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create/Update E-commerce Customer

**Slug:** `MAILERLITE_CREATE_ECOMMERCE_CUSTOMER`

Tool to create or update a customer record for a shop. Use when syncing shop customers or onboarding new purchases.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Customer's email address |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `total_spent` | number | No | Total amount the customer has spent in the shop |
| `accepts_marketing` | boolean | No | True if the customer accepts marketing emails, false otherwise |
| `create_subscriber` | boolean | No | If true and no subscriber exists, create a subscriber for the customer |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create E-commerce Order

**Slug:** `MAILERLITE_CREATE_ECOMMERCE_ORDER`

Tool to create a new order for a shop. Use when recording customer purchases or syncing order data from external systems.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cart` | object | Yes | Cart object containing items array with product details |
| `status` | string ("pending" | "complete") | No | 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. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop |
| `customer` | object | Yes | Customer object with email, create_subscriber, and accepts_marketing fields |
| `total_price` | number | No | Total order amount. If not provided, defaults to 0 |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create E-commerce Product

**Slug:** `MAILERLITE_CREATE_ECOMMERCE_PRODUCT`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create E-commerce Shop

**Slug:** `MAILERLITE_CREATE_ECOMMERCE_SHOP`

Tool to connect a new e-commerce shop. Use when you need to integrate a store for automations, product imports, and sales tracking.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Shop URL address |
| `name` | string | Yes | Shop name |
| `enabled` | boolean | No | Enable or disable e-commerce features for the shop. |
| `currency` | string | Yes | ISO 4217 currency code that the shop uses (e.g., USD, EUR) |
| `group_id` | integer | No | ID of the subscriber group to automatically add shop visitors to. |
| `platform` | string | No | Platform of the shop (e.g., shopify, woocommerce) |
| `access_data` | string | No | Platform-specific credentials (e.g., Shopify token or WooCommerce keys). |
| `enable_popups` | boolean | No | Enable popups on the shop (shop must have the universal script). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Field

**Slug:** `MAILERLITE_CREATE_FIELD`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the custom field (max 255 characters). |
| `type` | string ("text" | "number" | "date") | Yes | Type of the custom field; one of 'text', 'number', or 'date'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Group

**Slug:** `MAILERLITE_CREATE_GROUP`

Tool to create a new subscriber group. Use after deciding the group name for categorization. Store `group_id` from the response — required by MAILERLITE_UPDATE_GROUP, MAILERLITE_DELETE_GROUP, and MAILERLITE_GET_GROUP_SUBSCRIBERS.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new subscriber group (max 255 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Segment

**Slug:** `MAILERLITE_CREATE_SEGMENT`

Tool to create a new subscriber segment. Use when grouping subscribers by custom criteria before sending targeted campaigns.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new subscriber segment (max 255 characters). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Subscriber

**Slug:** `MAILERLITE_CREATE_SUBSCRIBER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Valid email address as per RFC 2821. Required field. |
| `fields` | object | No | 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. |
| `groups` | array | No | Array of existing group IDs to add subscriber to. Subscriber is only added, not removed by omission. |
| `status` | string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk") | No | Subscriber status. One of: active, unsubscribed, unconfirmed, bounced, junk. Defaults to 'active' if not specified. |
| `optin_ip` | string | No | Valid IP address used during opt-in. |
| `ip_address` | string | No | Valid IP address of the subscriber. |
| `opted_in_at` | string | No | Opt-in date in format: yyyy-MM-dd HH:mm:ss |
| `resubscribe` | boolean | No | Set to true to reactivate previously unsubscribed subscribers. |
| `subscribed_at` | string | No | Subscription date in format: yyyy-MM-dd HH:mm:ss |
| `unsubscribed_at` | string | No | Unsubscribe date in format: yyyy-MM-dd HH:mm:ss. Used when status is 'unsubscribed'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Webhook

**Slug:** `MAILERLITE_CREATE_WEBHOOK`

Tool to register a new webhook URL for specified event types. Use when you need real-time notifications for selected MailerLite events.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Endpoint URL where webhook notifications will be sent |
| `name` | string | No | Optional name for the webhook |
| `events` | array | Yes | List of events to subscribe to; choose from available webhook events |
| `enabled` | boolean | No | Whether the webhook is active; defaults to true |
| `batchable` | boolean | No | If true, events will be sent in batches. Required for campaign.open and campaign.click events |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Automation

**Slug:** `MAILERLITE_DELETE_AUTOMATION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `automation_id` | string | Yes | Unique identifier of the automation workflow to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete E-commerce Cart Item

**Slug:** `MAILERLITE_DELETE_ECOMMERCE_CART_ITEM`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cart_id` | string | Yes | Unique identifier of the cart. |
| `item_id` | string | Yes | Unique identifier of the cart item to delete. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete E-commerce Category

**Slug:** `MAILERLITE_DELETE_ECOMMERCE_CATEGORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `category_id` | string | Yes | Unique identifier of the category to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete E-commerce Customer

**Slug:** `MAILERLITE_DELETE_ECOMMERCE_CUSTOMER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `customer_id` | string | Yes | Unique identifier of the customer to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete E-commerce Order

**Slug:** `MAILERLITE_DELETE_ECOMMERCE_ORDER`

Tool to delete an order from a shop. Use when you need to remove an order and its associated cart from MailerLite. Returns the deleted order details on success.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | integer | Yes | Unique identifier of the e-commerce shop. |
| `order_id` | integer | Yes | Unique identifier of the order to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete E-commerce Product

**Slug:** `MAILERLITE_DELETE_ECOMMERCE_PRODUCT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop containing the product. |
| `product_id` | string | Yes | Unique identifier of the product to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete E-commerce Shop

**Slug:** `MAILERLITE_DELETE_ECOMMERCE_SHOP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Field

**Slug:** `MAILERLITE_DELETE_FIELD`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `field_id` | string | Yes | Unique identifier of the custom field to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Group

**Slug:** `MAILERLITE_DELETE_GROUP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the group to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Segment

**Slug:** `MAILERLITE_DELETE_SEGMENT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `segment_id` | string | Yes | The unique identifier of the segment to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Subscriber

**Slug:** `MAILERLITE_DELETE_SUBSCRIBER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | The unique identifier of the subscriber to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Webhook

**Slug:** `MAILERLITE_DELETE_WEBHOOK`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Execute Batch Request

**Slug:** `MAILERLITE_EXECUTE_BATCH_REQUEST`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `requests` | array | Yes | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Forget Subscriber

**Slug:** `MAILERLITE_FORGET_SUBSCRIBER`

Tool to forget a subscriber completely (GDPR compliant deletion). Use when you need to permanently delete all subscriber data within 30 days.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subscriber_id` | string | Yes | The unique identifier of the subscriber to forget. Data will be completely deleted in 30 days. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Info

**Slug:** `MAILERLITE_GET_ACCOUNT_INFO`

Tool to retrieve basic MailerLite account details. Use when you need to verify authentication and review account metadata. Response payload is nested under results[i].response.data with data and meta subkeys — not a flat data key. Does not return a dedicated sender-domain list; absent domain fields indicate unknown status, not verified or unverified.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Account Stats

**Slug:** `MAILERLITE_GET_ACCOUNT_STATS`

Tool to retrieve usage statistics and performance metrics for the account. Use after sending campaigns to analyze engagement and deliverability.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Automation

**Slug:** `MAILERLITE_GET_AUTOMATION`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `fields` | string | No | Comma-separated list of fields to include in the response |
| `automation_id` | string | Yes | Unique identifier of the automation to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Automation Activity

**Slug:** `MAILERLITE_GET_AUTOMATION_ACTIVITY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `automation_id` | string | Yes | Unique identifier of the automation to retrieve activity for |
| `filter_status` | string ("completed" | "active" | "canceled" | "failed") | Yes | Filter by activity status. REQUIRED parameter - must be one of: completed, active, canceled, failed |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaign Languages

**Slug:** `MAILERLITE_GET_CAMPAIGN_LANGUAGES`

Tool to retrieve a list of all available campaign languages. Use when you need to fetch supported languages for creating or configuring campaigns.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Campaigns

**Slug:** `MAILERLITE_GET_CAMPAIGNS`

Tool to retrieve a list of all campaigns. Use when you need to fetch campaigns optionally filtered by status or type, with pagination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | 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. |
| `type` | string ("regular" | "ab" | "resend" | "rss") | No | Filter campaigns by type: 'regular', 'ab', 'resend', or 'rss'. |
| `limit` | integer | No | 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. |
| `status` | string ("sent" | "draft" | "ready") | No | Filter campaigns by status: 'sent', 'draft', or 'ready'. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Cart

**Slug:** `MAILERLITE_GET_ECOMMERCE_CART`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cart_id` | string | Yes | Unique identifier of the cart to retrieve. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Cart Item

**Slug:** `MAILERLITE_GET_ECOMMERCE_CART_ITEM`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cart_id` | string | Yes | Unique identifier of the cart. |
| `item_id` | string | Yes | Unique identifier of the cart item to retrieve. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Category

**Slug:** `MAILERLITE_GET_ECOMMERCE_CATEGORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `category_id` | string | Yes | Unique identifier of the product category to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Customer

**Slug:** `MAILERLITE_GET_ECOMMERCE_CUSTOMER`

Tool to fetch details of a customer by shop and customer ID. Use after confirming shop_id and customer_id.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | integer | Yes | Unique identifier of the e-commerce shop. |
| `customer_id` | integer | Yes | Unique identifier of the customer within the shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Customers

**Slug:** `MAILERLITE_GET_ECOMMERCE_CUSTOMERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. Defaults to 1 if not provided. |
| `limit` | integer | No | Number of customers per page. Defaults to server-side default if not provided. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Order

**Slug:** `MAILERLITE_GET_ECOMMERCE_ORDER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `order_id` | string | Yes | Unique identifier of the order to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Product

**Slug:** `MAILERLITE_GET_ECOMMERCE_PRODUCT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `product_id` | string | Yes | Unique identifier of the product to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Shop

**Slug:** `MAILERLITE_GET_ECOMMERCE_SHOP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get E-commerce Shops

**Slug:** `MAILERLITE_GET_ECOMMERCE_SHOPS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. Defaults to 1 if not provided. |
| `limit` | integer | No | Number of items per page. Defaults to 50 if not provided. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Fields

**Slug:** `MAILERLITE_GET_FIELDS`

Tool to retrieve all custom fields defined in the account. Use when you need to list or paginate through subscriber custom fields.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. |
| `sort` | string ("name" | "type" | "-name" | "-type") | No | Sort fields by 'name' or 'type'; prepend with '-' for descending order. |
| `limit` | integer | No | Maximum number of fields to return. |
| `filter_type` | string ("text" | "number" | "date") | No | Filter fields by type; one of 'text', 'number', 'date'. |
| `filter_keyword` | string | No | Filter fields by keyword (matches name or key). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Group

**Slug:** `MAILERLITE_GET_GROUP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the group to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Groups

**Slug:** `MAILERLITE_GET_GROUPS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (starting from 1). Increment page until an empty result set is returned to retrieve all groups. |
| `sort` | string ("name" | "total" | "open_rate" | "click_rate" | "created_at" | "-name" | "-total" | "-open_rate" | "-click_rate" | "-created_at") | No | Sort results by field. Prepend with '-' for descending order. |
| `limit` | integer | No | Maximum number of groups to return. |
| `filter_name` | string | No | 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Group Subscribers

**Slug:** `MAILERLITE_GET_GROUP_SUBSCRIBERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of subscribers to return per page. |
| `cursor` | string | No | Cursor token for pagination (from meta.next_cursor). |
| `include` | string | No | Include additional resources. Currently only 'groups'. |
| `group_id` | string | Yes | Unique identifier of the group. |
| `filter_status` | string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk") | No | Filter subscribers by status: active, unsubscribed, unconfirmed, bounced, or junk. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Import Status

**Slug:** `MAILERLITE_GET_IMPORT_STATUS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `import_id` | string | Yes | The unique identifier of the subscriber import operation obtained from POST /groups/{group_id}/import-subscribers |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Segment

**Slug:** `MAILERLITE_GET_SEGMENT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `segment_id` | string | Yes | The unique ID of the segment to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Segments

**Slug:** `MAILERLITE_GET_SEGMENTS`

Tool to retrieve all segments in the account. Use when you need to list or paginate through segments.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (starting from 1) |
| `limit` | integer | No | Maximum number of segments to return (max 250) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Segment Subscribers

**Slug:** `MAILERLITE_GET_SEGMENT_SUBSCRIBERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cursor` | string | No | Cursor token for pagination (from meta.next_cursor in previous response). |
| `per_page` | integer | No | Number of subscribers to return per page (default 25). |
| `segment_id` | string | Yes | Unique identifier of the segment to get subscribers from. |
| `filter_status` | string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk") | No | Filter subscribers by status: active, unsubscribed, unconfirmed, bounced, or junk. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscriber

**Slug:** `MAILERLITE_GET_SUBSCRIBER`

Tool to fetch a single subscriber by ID or email address. Use when you need to retrieve detailed information about a specific subscriber.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `subscriber_id` | string | Yes | The subscriber ID (numeric string) or email address to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscriber Activity

**Slug:** `MAILERLITE_GET_SUBSCRIBER_ACTIVITY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of activity log entries to return per page. Default: 25, Maximum: 100. |
| `cursor` | string | No | Pagination cursor for fetching the next page of results. Obtained from the previous response's pagination metadata. |
| `filter_type` | string | No | 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. |
| `subscriber_id` | string | Yes | The unique identifier of the subscriber to fetch activity log for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscribers

**Slug:** `MAILERLITE_GET_SUBSCRIBERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `limit` | integer | No | Number of subscribers per page. Defaults to server default (usually 25). |
| `cursor` | string | No | 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. |
| `include` | string | No | 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. |
| `filter_status` | string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk") | No | Filter subscribers by status: active, unsubscribed, unconfirmed, bounced, or junk. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Subscribers Stats

**Slug:** `MAILERLITE_GET_SUBSCRIBERS_STATS`

Tool to get subscriber statistics for the account. Use to retrieve counts of total, active, unsubscribed, unconfirmed, bounced, and junk subscribers.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `x_locale` | string | No | Locale for the response (e.g., 'en', 'pl'). If not provided, defaults to account's default locale. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhook

**Slug:** `MAILERLITE_GET_WEBHOOK`

Tool to retrieve details of a specific webhook by ID. Use when you need to get information about a particular webhook configuration.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `webhook_id` | string | Yes | Unique identifier of the webhook to retrieve. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhooks

**Slug:** `MAILERLITE_GET_WEBHOOKS`

Tool to retrieve all configured webhooks. Use when you need to list webhooks for your MailerLite account.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import E-commerce Categories

**Slug:** `MAILERLITE_IMPORT_ECOMMERCE_CATEGORIES`

Tool to bulk import categories to an e-commerce shop. Use when you need to add multiple categories at once to a shop.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `categories` | array | Yes | Array of category objects to import. Each category must have a name. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import E-commerce Orders

**Slug:** `MAILERLITE_IMPORT_ECOMMERCE_ORDERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `orders` | array | Yes | Array of order objects to import. Must contain at least one order. |
| `shop_id` | integer | Yes | Unique identifier of the e-commerce shop to import orders into. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import E-commerce Products

**Slug:** `MAILERLITE_IMPORT_ECOMMERCE_PRODUCTS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | integer | Yes | ID of the e-commerce shop. |
| `products` | array | Yes | Array of product objects to import (at least one required). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Import Subscribers to Group

**Slug:** `MAILERLITE_IMPORT_SUBSCRIBERS_TO_GROUP`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Automations

**Slug:** `MAILERLITE_LIST_AUTOMATIONS`

Tool 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

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

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List E-commerce Cart Items

**Slug:** `MAILERLITE_LIST_ECOMMERCE_CART_ITEMS`

Tool to list all items in a specific cart for an e-commerce shop. Use when you need to retrieve items from a cart after you have both a shop ID and cart ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. Defaults to 1 if not provided. |
| `limit` | integer | No | Number of items per page. Defaults to 100 if not provided. |
| `cart_id` | string | Yes | Unique identifier of the cart. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List E-commerce Carts

**Slug:** `MAILERLITE_LIST_ECOMMERCE_CARTS`

Tool to list all carts for a specific shop. Use when you need to retrieve abandoned or active shopping carts after you have a shop ID. Example: "List carts for shop 49095".

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. Defaults to 1 if not provided. |
| `limit` | integer | No | Number of carts per page. Defaults to 100 if not provided. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List E-commerce Categories

**Slug:** `MAILERLITE_LIST_ECOMMERCE_CATEGORIES`

Tool to list all product categories for a shop. Use when you need to retrieve or paginate through categories.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (starting from 1). |
| `limit` | integer | No | Number of records per page. |
| `shop_id` | integer | Yes | The ID of the shop to list categories for. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List E-commerce Category Products

**Slug:** `MAILERLITE_LIST_ECOMMERCE_CATEGORY_PRODUCTS`

Tool to list all products in a specific e-commerce category. Use when you need to retrieve products for a given shop and category combination.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. Defaults to 1 if not provided. |
| `limit` | integer | No | Maximum number of products per page. Defaults to 100 if not provided. |
| `shop_id` | integer | Yes | Unique identifier of the e-commerce shop. |
| `category_id` | integer | Yes | Unique identifier of the category. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List E-commerce Orders

**Slug:** `MAILERLITE_LIST_ECOMMERCE_ORDERS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve. Defaults to 1 if not provided. |
| `limit` | integer | No | Number of orders per page. Defaults to 100 if not provided. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List E-commerce Products

**Slug:** `MAILERLITE_LIST_ECOMMERCE_PRODUCTS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. Defaults to 1 if not provided. |
| `limit` | integer | No | Number of results per page. Defaults to 100 if not provided. |
| `shop_id` | integer | Yes | Unique identifier of the e-commerce shop. Must provide valid shop id. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Forms

**Slug:** `MAILERLITE_LIST_FORMS`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number to retrieve (starting from 1). |
| `sort` | string | No | Sort options: created_at, name, conversions_count, opens_count, visitors, conversion_rate, last_registration_at. Prepend '-' for descending order. |
| `type` | string ("popup" | "embedded" | "promotion") | Yes | Type of forms to list: 'popup', 'embedded', or 'promotion'. |
| `limit` | integer | No | Maximum number of forms to return per page. |
| `filter_name` | string | No | Filter forms by name; returns partial matches. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Timezones

**Slug:** `MAILERLITE_LIST_TIMEZONES`

Tool to retrieve all available timezones supported by MailerLite. Use when you need to get timezone options for campaigns, automations, or scheduling.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Product From Category

**Slug:** `MAILERLITE_REMOVE_PRODUCT_FROM_CATEGORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `shop_id` | integer | Yes | Unique identifier of the e-commerce shop. |
| `product_id` | integer | Yes | Unique identifier of the product to remove from the category. |
| `category_id` | integer | Yes | Unique identifier of the category to remove the product from. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Remove Subscriber From Group

**Slug:** `MAILERLITE_REMOVE_SUBSCRIBER_FROM_GROUP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | string | Yes | The unique identifier of the group to remove the subscriber from. |
| `subscriber_id` | string | Yes | The unique identifier of the subscriber to remove from the group. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Set Double Opt-In

**Slug:** `MAILERLITE_SET_DOUBLE_OPTIN`

Tool to enable or disable double opt-in for new subscribers. Use when configuring subscription confirmation settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `double_opt_in` | boolean | Yes | Enable double opt-in for new subscribers if True, disable if False. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update E-commerce Cart

**Slug:** `MAILERLITE_UPDATE_ECOMMERCE_CART`

Tool to update an existing cart's checkout URL or total price. Use when you need to modify cart details like the checkout link or recalculate the cart total for an active shopping cart.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `cart_id` | string | Yes | Unique identifier of the cart to update. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `cart_total` | number | No | The cart's total price in the shop's currency. Defaults to 0 if not provided. |
| `checkout_url` | string | No | The cart's checkout URL where customers can complete their purchase. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update E-commerce Cart Item

**Slug:** `MAILERLITE_UPDATE_ECOMMERCE_CART_ITEM`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `price` | number | No | Price of the cart item. Defaults to 0 if not provided. |
| `cart_id` | string | Yes | Unique identifier of the cart. |
| `item_id` | string | Yes | Unique identifier of the cart item to update. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop. |
| `variant` | string | No | The product's variant information (e.g., 'Color red, size large'). |
| `quantity` | integer | No | Quantity of the product in the cart. Defaults to 1 if not provided. |
| `ecommerce_product_id` | integer | Yes | The ID of the product associated with this cart item. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update E-commerce Category

**Slug:** `MAILERLITE_UPDATE_ECOMMERCE_CATEGORY`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | The category's name |
| `shop_id` | string | Yes | Valid shop identifier |
| `category_id` | string | Yes | Valid category identifier |
| `exclude_from_automations` | boolean | No | When true, the category won't trigger automations; defaults to false |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update E-commerce Customer

**Slug:** `MAILERLITE_UPDATE_ECOMMERCE_CUSTOMER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Valid email address of the customer. |
| `shop_id` | string | Yes | ID of the e-commerce shop. |
| `customer_id` | string | Yes | ID of the customer to update. |
| `total_spent` | number | No | Total amount the customer has spent in the shop. |
| `accepts_marketing` | boolean | No | True if the customer accepts marketing emails. |
| `create_subscriber` | boolean | No | If true, creates or associates a subscriber for this customer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update E-commerce Order

**Slug:** `MAILERLITE_UPDATE_ECOMMERCE_ORDER`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `status` | string ("pending" | "complete") | No | Enum for order status values. |
| `shop_id` | string | Yes | ID of the e-commerce shop containing the order. |
| `order_id` | string | Yes | ID of the order to update. |
| `total_price` | number | No | The order's total price. Must be non-negative. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update E-commerce Product

**Slug:** `MAILERLITE_UPDATE_ECOMMERCE_PRODUCT`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | Product URL address. |
| `name` | string | Yes | Product name. |
| `image` | string | No | Main product image URL. |
| `price` | number | No | Price in shop currency; defaults to 0 if not provided. |
| `shop_id` | string | Yes | Unique identifier of the e-commerce shop containing the product. |
| `product_id` | string | Yes | Unique identifier of the product to update. |
| `description` | string | No | Full product description. HTML tags are automatically removed. |
| `short_description` | string | No | Short product description (max 255 characters). HTML tags are automatically removed. |
| `exclude_from_automations` | boolean | No | If true, prevents this product from triggering automations; defaults to false. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update E-commerce Shop

**Slug:** `MAILERLITE_UPDATE_ECOMMERCE_SHOP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Shop URL address |
| `name` | string | Yes | Shop name |
| `enabled` | boolean | No | Enable e-commerce functionality for the shop; defaults to false |
| `shop_id` | string | Yes | ID of the e-commerce shop to update |
| `currency` | string | Yes | ISO 4217 currency code that the shop uses |
| `group_id` | integer | No | ID of the group that shop subscribers are automatically added to |
| `platform` | string | No | E-commerce platform of the shop (e.g., Shopify) |
| `access_data` | string | No | Platform-specific access credential for the shop |
| `enable_popups` | boolean | No | Enable popups for the shop; defaults to false |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Field

**Slug:** `MAILERLITE_UPDATE_FIELD`

Tool to update the title of an existing custom field. Use when renaming a field label (e.g., correct typos or rebranding).

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | New name for the custom field (max 255 characters) |
| `field_id` | string | Yes | ID of the custom field to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Group

**Slug:** `MAILERLITE_UPDATE_GROUP`

Tool 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Group's unique identifier |
| `name` | string | Yes | New name for the group (max 255 characters) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Segment

**Slug:** `MAILERLITE_UPDATE_SEGMENT`

Tool to rename an existing segment by ID. Use when you need to update a segment's name after confirming its ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Segment's unique identifier |
| `name` | string | Yes | New name for the segment (max 255 characters) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Subscriber

**Slug:** `MAILERLITE_UPDATE_SUBSCRIBER`

Tool to update an existing subscriber's information by ID. Use when altering subscriber details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Subscriber's unique identifier |
| `fields` | object | No | Mapping of field names to values; omissions do not remove fields. |
| `groups` | array | No | List of group IDs to assign; subscriber will be removed from others. |
| `status` | string ("active" | "unsubscribed" | "unconfirmed" | "bounced" | "junk") | No | Subscriber status. |
| `optin_ip` | string | No | IP address used when subscriber opted in. |
| `ip_address` | string | No | IP address for subscription record. |
| `opted_in_at` | string | No | Opt-in timestamp in 'YYYY-MM-DD HH:MM:SS' format. |
| `subscribed_at` | string | No | Custom subscription timestamp in 'YYYY-MM-DD HH:MM:SS' format. |
| `unsubscribed_at` | string | No | Unsubscription timestamp in 'YYYY-MM-DD HH:MM:SS' format. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Webhook

**Slug:** `MAILERLITE_UPDATE_WEBHOOK`

Tool to update an existing MailerLite webhook. Use when you need to change its URL or event triggers by ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | Yes | Endpoint URL where webhook notifications will be sent |
| `name` | string | No | Optional new name for the webhook |
| `events` | array | Yes | List of events to subscribe to; choose from available webhook events |
| `enabled` | boolean | No | Whether the webhook should be active; defaults to current setting |
| `batchable` | boolean | No | Whether the webhook should use batched deliveries |
| `webhook_id` | string | Yes | ID of the webhook to update |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | string | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |