Skip to main content
MailBluster logo
  • Category: email newsletters
  • Auth: API_KEY
  • Composio-managed OAuth available? N/A
  • Tools: 15
  • Triggers: 0
  • Slug: MAILBLUSTER
  • Version: 20261101_00

Tools

Slug: MAILBLUSTER_CREATE_LEADCreate 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

array
List of tags to assign to this lead
string
required
Lead’s email address
string
Additional custom fields as key-value pairs or list of such objects
string
Last name of the lead
string
First name of the lead
boolean
Subscription status. true = subscribed, false = unsubscribed

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_CREATE_ORDERTool to create a new order in MailBluster.

Input Parameters

string
required
Unique identifier for the order
array
required
List of items in the order
string
required
Currency code, e.g. ‘USD’, ‘EUR’, ‘AUD’
object
required
Customer information including email. If no lead is found with this email, a new lead will be created.
string
IP address of the customer placing the order
number
required
Total price of the order

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_CREATE_PRODUCTTool 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

string
required
Unique identifier for the product. This is required by MailBluster API.
string
Public URL of the product.
string
required
Name/title of the product.
number
Price of the product in USD, must be non-negative.
string
URL pointing to the product image.
boolean
Whether the product should be published immediately.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_DELETE_LEADTool to delete a lead by lead email hash. Use after confirming the lead hash (MD5 encrypted email address).

Input Parameters

string
required
MD5 encrypted value of lead email that you want to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_DELETE_ORDERTool to delete a specific order. Use after confirming the order ID to remove an order from Mailbluster.

Input Parameters

string
required
The unique identifier of the order to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_DELETE_PRODUCTTool to delete a product. Use after confirming product existence.

Input Parameters

string
required
The unique identifier of the product to delete.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_GET_LEADTool 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

string
required
MD5 encrypted value of the lead’s email address

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_GET_ORDERTool to retrieve details of a specific order. Use when you have the order’s ID.

Input Parameters

string
required
The unique identifier of the order to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_GET_PRODUCTRetrieve 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

string
required
Unique identifier of the product to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_LIST_FIELDSList all defined custom fields in MailBluster. Use this to retrieve the available fields and their details for the authenticated account.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_LIST_ORDERSTool to list all orders. Use when you need to retrieve orders with optional pagination, sorting, or searching after authenticating with Mailbluster.

Input Parameters

integer
Page number for pagination.
string
Field to sort by (e.g., ‘id’, ‘email’, ‘createdAt’).
integer
Number of orders per page.
string ("asc" | "desc")
Sort order: ‘asc’ or ‘desc’.
Search term to filter the orders.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_LIST_PRODUCTSList MailBluster products with optional pagination.

Input Parameters

integer
Page number for pagination (starts from 1).
integer
Number of results per page.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_UPDATE_LEADTool to update an existing lead’s information in MailBluster. Use when you need to modify lead details, subscription status, or manage tags.

Input Parameters

string
Email address of the lead
object
An object containing field information of the lead
array
Tag names that will be attached to this lead
string
Last name of the lead
string
Timezone of the lead
string
First name of the lead
string
IP address of the lead
string
required
MD5 encrypted value of lead email that you want to update
array
Tag names that will be detached from this lead
boolean
Lead is subscribed to receive email or not

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_UPDATE_ORDERTool to update an existing order’s customer details, currency, price, and items in MailBluster. Use when you need to modify an order.

Input Parameters

array
The products list of this order. If given, replaces all previous items
string
The currency code of the order
object
Customer information for updating an order.
string
required
Unique ID of the order that you want to update
integer
The related campaign ID of the order
number
The total price of the order

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: MAILBLUSTER_UPDATE_PRODUCTTool to update a product in MailBluster by its ID. Use after confirming the product ID to modify attributes.

Input Parameters

string
New URL where the product can be found
string
required
Name for the product (required for all updates)
number
New price of the product, must be non-negative
string
Currency code (e.g., USD)
string
URL to the product’s image
string
required
Unique identifier of the product to update
string
Description of the product

Output

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