> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# MailBluster

> MailBluster is an advanced, reliable, and cost-effective email marketing software that enables sending personalized promotional emails to millions.

![MailBluster logo](https://mintcdn.com/composio-preview/ufpARLIsio16odJB/images/toolkits/mailbluster.svg?fit=max\&auto=format\&n=ufpARLIsio16odJB\&q=85\&s=43435914ec4868fc76f02ef200c54a8d)

* **Category:** email newsletters
* **Auth:** API\_KEY
* **Composio-managed OAuth available?** N/A
* **Tools:** 15
* **Triggers:** 0
* **Slug:** `MAILBLUSTER`
* **Version:** 20261101\_00

## Tools

> [accordion] Create MailBluster Lead
>
> **Slug:** `MAILBLUSTER_CREATE_LEAD`
>
> Create a lead in MailBluster using an email address and optional details. The request defaults the lead's subscription status to subscribed unless specified otherwise.
>
> #### Input Parameters
>
> **tags** `array`
>
> List of tags to assign to this lead
>
> **email** `string` *required*
>
> Lead's email address
>
> **fields** `string`
>
> Additional custom fields as key-value pairs or list of such objects
>
> **lastName** `string`
>
> Last name of the lead
>
> **firstName** `string`
>
> First name of the lead
>
> **subscribed** `boolean`
>
> Subscription status. true = subscribed, false = unsubscribed
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Order
>
> **Slug:** `MAILBLUSTER_CREATE_ORDER`
>
> Tool to create a new order in MailBluster.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier for the order
>
> **items** `array` *required*
>
> List of items in the order
>
> **currency** `string` *required*
>
> Currency code, e.g. 'USD', 'EUR', 'AUD'
>
> **customer** `object` *required*
>
> Customer information including email. If no lead is found with this email, a new lead will be created.
>
> **ipAddress** `string`
>
> IP address of the customer placing the order
>
> **totalPrice** `number` *required*
>
> Total price of the order
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Create Product
>
> **Slug:** `MAILBLUSTER_CREATE_PRODUCT`
>
> Tool to create a new product in MailBluster. Use when you have all product details ready to add it to your MailBluster catalog. Requires a unique product ID and name.
>
> #### Input Parameters
>
> **id** `string` *required*
>
> Unique identifier for the product. This is required by MailBluster API.
>
> **url** `string`
>
> Public URL of the product.
>
> **name** `string` *required*
>
> Name/title of the product.
>
> **price** `number`
>
> Price of the product in USD, must be non-negative.
>
> **imageUrl** `string`
>
> URL pointing to the product image.
>
> **published** `boolean`
>
> Whether the product should be published immediately.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete MailBluster Lead
>
> **Slug:** `MAILBLUSTER_DELETE_LEAD`
>
> Tool to delete a lead by lead email hash. Use after confirming the lead hash (MD5 encrypted email address).
>
> #### Input Parameters
>
> **lead\_hash** `string` *required*
>
> MD5 encrypted value of lead email that you want to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Order
>
> **Slug:** `MAILBLUSTER_DELETE_ORDER`
>
> Tool to delete a specific order. Use after confirming the order ID to remove an order from Mailbluster.
>
> #### Input Parameters
>
> **order\_id** `string` *required*
>
> The unique identifier of the order to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Delete Mailbluster Product
>
> **Slug:** `MAILBLUSTER_DELETE_PRODUCT`
>
> Tool to delete a product. Use after confirming product existence.
>
> #### Input Parameters
>
> **product\_id** `string` *required*
>
> The unique identifier of the product to delete.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Lead
>
> **Slug:** `MAILBLUSTER_GET_LEAD`
>
> Tool to retrieve a specific lead's information using their lead hash (MD5 encrypted email address). Use when you need to fetch lead details by their email hash.
>
> #### Input Parameters
>
> **lead\_hash** `string` *required*
>
> MD5 encrypted value of the lead's email address
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Order
>
> **Slug:** `MAILBLUSTER_GET_ORDER`
>
> Tool to retrieve details of a specific order. Use when you have the order's ID.
>
> #### Input Parameters
>
> **order\_id** `string` *required*
>
> The unique identifier of the order to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get Product
>
> **Slug:** `MAILBLUSTER_GET_PRODUCT`
>
> Retrieve details of a specific MailBluster product by its ID. The returned product is limited to the fields in the tool's response model.
>
> #### Input Parameters
>
> **product\_id** `string` *required*
>
> Unique identifier of the product to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Fields
>
> **Slug:** `MAILBLUSTER_LIST_FIELDS`
>
> List all defined custom fields in MailBluster. Use this to retrieve the available fields and their details for the authenticated account.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Orders
>
> **Slug:** `MAILBLUSTER_LIST_ORDERS`
>
> Tool to list all orders. Use when you need to retrieve orders with optional pagination, sorting, or searching after authenticating with Mailbluster.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination.
>
> **sort** `string`
>
> Field to sort by (e.g., 'id', 'email', 'createdAt').
>
> **limit** `integer`
>
> Number of orders per page.
>
> **order** `string ("asc" | "desc")`
>
> Sort order: 'asc' or 'desc'.
>
> **search** `string`
>
> Search term to filter the orders.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Products
>
> **Slug:** `MAILBLUSTER_LIST_PRODUCTS`
>
> List MailBluster products with optional pagination.
>
> #### Input Parameters
>
> **pageNo** `integer`
>
> Page number for pagination (starts from 1).
>
> **perPage** `integer`
>
> Number of results per page.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update MailBluster Lead
>
> **Slug:** `MAILBLUSTER_UPDATE_LEAD`
>
> Tool to update an existing lead's information in MailBluster. Use when you need to modify lead details, subscription status, or manage tags.
>
> #### Input Parameters
>
> **email** `string`
>
> Email address of the lead
>
> **fields** `object`
>
> An object containing field information of the lead
>
> **addTags** `array`
>
> Tag names that will be attached to this lead
>
> **lastName** `string`
>
> Last name of the lead
>
> **timezone** `string`
>
> Timezone of the lead
>
> **firstName** `string`
>
> First name of the lead
>
> **ipAddress** `string`
>
> IP address of the lead
>
> **lead\_hash** `string` *required*
>
> MD5 encrypted value of lead email that you want to update
>
> **removeTags** `array`
>
> Tag names that will be detached from this lead
>
> **subscribed** `boolean`
>
> Lead is subscribed to receive email or not
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Update Order
>
> **Slug:** `MAILBLUSTER_UPDATE_ORDER`
>
> Tool to update an existing order's customer details, currency, price, and items in MailBluster. Use when you need to modify an order.
>
> #### Input Parameters
>
> **items** `array`
>
> The products list of this order. If given, replaces all previous items
>
> **currency** `string`
>
> The currency code of the order
>
> **customer** `object`
>
> Customer information for updating an order.
>
> **order\_id** `string` *required*
>
> Unique ID of the order that you want to update
>
> **campaignId** `integer`
>
> The related campaign ID of the order
>
> **totalPrice** `number`
>
> The total price of the order
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] MailBluster Update Product
>
> **Slug:** `MAILBLUSTER_UPDATE_PRODUCT`
>
> Tool to update a product in MailBluster by its ID. Use after confirming the product ID to modify attributes.
>
> #### Input Parameters
>
> **url** `string`
>
> New URL where the product can be found
>
> **name** `string` *required*
>
> Name for the product (required for all updates)
>
> **price** `number`
>
> New price of the product, must be non-negative
>
> **currency** `string`
>
> Currency code (e.g., USD)
>
> **imageUrl** `string`
>
> URL to the product's image
>
> **productId** `string` *required*
>
> Unique identifier of the product to update
>
> **description** `string`
>
> Description of the product
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
