NagentArtefacts
Dev & Technology
Enterprise and White Glove
Company
MailBluster connects to a Nagent workspace with an API key. Once it is connected, agents can call 15 MailBluster actions, such as "Create MailBluster Lead", "Create Order" and "Create Product". Nothing is enabled on connect: each action is allowed one at a time, and an action with side effects runs or waits for a person according to the agent's level.
Every operation an agent can call against MailBluster, with input parameters and output schema.
MAILBLUSTER_CREATE_LEADTool to create a new lead in MailBluster. Use after gathering the lead's email and optional data.
Input parameters
List of tags to assign to this lead
Lead's email address
Additional custom fields as key-value pairs or list of such objects
Last name of the lead
First name of the lead
Subscription status. true = subscribed, false = unsubscribed
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_CREATE_ORDERTool to create a new order in MailBluster.
Input parameters
Unique identifier for the order
List of items in the order
Currency code, e.g. 'USD', 'EUR', 'AUD'
Customer information including email. If no lead is found with this email, a new lead will be created.
IP address of the customer placing the order
Total price of the order
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Unique identifier for the product. This is required by MailBluster API.
Public URL of the product.
Name/title of the product.
Price of the product in USD, must be non-negative.
URL pointing to the product image.
Whether the product should be published immediately.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_DELETE_LEADTool to delete a lead by lead email hash. Use after confirming the lead hash (MD5 encrypted email address).
Input parameters
MD5 encrypted value of lead email that you want to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_DELETE_ORDERTool to delete a specific order. Use after confirming the order ID to remove an order from Mailbluster.
Input parameters
The unique identifier of the order to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_DELETE_PRODUCTTool to delete a product. Use after confirming product existence.
Input parameters
The unique identifier of the product to delete.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
MD5 encrypted value of the lead's email address
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_GET_ORDERTool to retrieve details of a specific order. Use when you have the order's ID.
Input parameters
The unique identifier of the order to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_GET_PRODUCTTool to retrieve details of a specific product. Use when you have a valid product ID and need full product information.
Input parameters
Unique identifier of the product to retrieve
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_LIST_FIELDSTool to list all custom fields. Use when you need to retrieve all defined custom fields after authenticating with MailBluster.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Page number for pagination.
Field to sort by (e.g., 'id', 'email', 'createdAt').
Number of orders per page.
Sort order: 'asc' or 'desc'.
Search term to filter the orders.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_LIST_PRODUCTSTool to list all products. Use when you need to retrieve products with optional pagination, sorting, or filtering.
Input parameters
Page number for pagination (starts from 1).
Number of results per page.
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
Email address of the lead
An object containing field information of the lead
Tag names that will be attached to this lead
Last name of the lead
Timezone of the lead
First name of the lead
IP address of the lead
MD5 encrypted value of lead email that you want to update
Tag names that will be detached from this lead
Lead is subscribed to receive email or not
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
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
The products list of this order. If given, replaces all previous items
The currency code of the order
Customer information for updating an order.
Unique ID of the order that you want to update
The related campaign ID of the order
The total price of the order
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
MAILBLUSTER_UPDATE_PRODUCTTool to update a product in MailBluster by its ID. Use after confirming the product ID to modify attributes.
Input parameters
New URL where the product can be found
Name for the product (required for all updates)
New price of the product, must be non-negative
Currency code (e.g., USD)
URL to the product's image
Unique identifier of the product to update
Description of the product
Output
Data from the action execution
Error if any occurred during the execution of the action
Whether or not the action execution was successful or not
Agents can call 15 MailBluster actions on Nagent, including "Create MailBluster Lead", "Create Order" and "Create Product". Create MailBluster Lead: Create a new lead in MailBluster. Each action is listed on this page with its input parameters and its output.
MailBluster connects with an API key, under your workspace's own connection. Nothing is enabled on connect: each action is allowed one at a time and can be scoped to the agents that need it.
Create MailBluster Lead takes 1 required input: email. It also takes 5 optional inputs: tags, fields, lastName, firstName and subscribed. It returns data, error and successful.