# MailBluster

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

- **Category:** email newsletters
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 15
- **Triggers:** 0
- **Slug:** `MAILBLUSTER`
- **Version:** 20260223_00

## Tools

### Create MailBluster Lead

**Slug:** `MAILBLUSTER_CREATE_LEAD`

Tool to create a new lead in MailBluster. Use after gathering the lead's email and optional data.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tags` | array | No | List of tags to assign to this lead |
| `email` | string | Yes | Lead's email address |
| `fields` | string | No | Additional custom fields as key-value pairs or list of such objects |
| `lastName` | string | No | Last name of the lead |
| `firstName` | string | No | First name of the lead |
| `subscribed` | boolean | No | Subscription status. true = subscribed, false = 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 Order

**Slug:** `MAILBLUSTER_CREATE_ORDER`

Tool to create a new order in MailBluster.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier for the order |
| `items` | array | Yes | List of items in the order |
| `currency` | string | Yes | Currency code, e.g. 'USD', 'EUR', 'AUD' |
| `customer` | object | Yes | Customer information including email. If no lead is found with this email, a new lead will be created. |
| `ipAddress` | string | No | IP address of the customer placing the order |
| `totalPrice` | number | Yes | Total price of the order |

#### 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `id` | string | Yes | Unique identifier for the product. This is required by MailBluster API. |
| `url` | string | No | Public URL of the product. |
| `name` | string | Yes | Name/title of the product. |
| `price` | number | No | Price of the product in USD, must be non-negative. |
| `imageUrl` | string | No | URL pointing to the product image. |
| `published` | boolean | No | Whether the product should be published immediately. |

#### 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lead_hash` | string | Yes | MD5 encrypted value of lead email that you want 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order_id` | string | Yes | The 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 Mailbluster Product

**Slug:** `MAILBLUSTER_DELETE_PRODUCT`

Tool to delete a product. Use after confirming product existence.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `product_id` | string | Yes | The 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 |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `lead_hash` | string | Yes | MD5 encrypted value of the lead's email address |

#### 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 Order

**Slug:** `MAILBLUSTER_GET_ORDER`

Tool to retrieve details of a specific order. Use when you have the order's ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `order_id` | string | Yes | The 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 Product

**Slug:** `MAILBLUSTER_GET_PRODUCT`

Tool to retrieve details of a specific product. Use when you have a valid product ID and need full product information.

#### Input Parameters

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

### List Fields

**Slug:** `MAILBLUSTER_LIST_FIELDS`

Tool to list all custom fields. Use when you need to retrieve all defined custom fields after authenticating with MailBluster.

#### 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination. |
| `sort` | string | No | Field to sort by (e.g., 'id', 'email', 'createdAt'). |
| `limit` | integer | No | Number of orders per page. |
| `order` | string ("asc" | "desc") | No | Sort order: 'asc' or 'desc'. |
| `search` | string | No | Search term to filter the orders. |

#### 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 Products

**Slug:** `MAILBLUSTER_LIST_PRODUCTS`

Tool to list all products. Use when you need to retrieve products with optional pagination, sorting, or filtering.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `pageNo` | integer | No | Page number for pagination (starts from 1). |
| `perPage` | integer | No | Number of results per page. |

#### 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | No | Email address of the lead |
| `fields` | object | No | An object containing field information of the lead |
| `addTags` | array | No | Tag names that will be attached to this lead |
| `lastName` | string | No | Last name of the lead |
| `timezone` | string | No | Timezone of the lead |
| `firstName` | string | No | First name of the lead |
| `ipAddress` | string | No | IP address of the lead |
| `lead_hash` | string | Yes | MD5 encrypted value of lead email that you want to update |
| `removeTags` | array | No | Tag names that will be detached from this lead |
| `subscribed` | boolean | No | Lead is subscribed to receive email or not |

#### 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 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `items` | array | No | The products list of this order. If given, replaces all previous items |
| `currency` | string | No | The currency code of the order |
| `customer` | object | No | Customer information for updating an order. |
| `order_id` | string | Yes | Unique ID of the order that you want to update |
| `campaignId` | integer | No | The related campaign ID of the order |
| `totalPrice` | number | No | The total price of the order |

#### 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 |

### 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

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `url` | string | No | New URL where the product can be found |
| `name` | string | Yes | Name for the product (required for all updates) |
| `price` | number | No | New price of the product, must be non-negative |
| `currency` | string | No | Currency code (e.g., USD) |
| `imageUrl` | string | No | URL to the product's image |
| `product_id` | string | Yes | Unique identifier of the product to update |
| `description` | string | No | Description of the product |

#### 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 |