The Mandrill (Mailchimp Transactional) connector lets your AI agent act in each user's Mandrill (Mailchimp Transactional) account. Each user connects their own Mandrill (Mailchimp Transactional) API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 61 tools.
- Tools
- 61
- What they doRead · write · destructive
- 33 · 18 · 1033 read18 write10 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Mandrill (Mailchimp Transactional) connection
In AgentKit > Connections, create a Mandrill (Mailchimp Transactional) connection. The name you give it is the
connection_nameyour code passes. See Configure connections.Authorize a user and make your first call
quickstart.mts import { ScalekitClient } from '@scalekit-sdk/node'import 'dotenv/config'import { createInterface } from 'node:readline/promises'const scalekit = new ScalekitClient(process.env.SCALEKIT_ENVIRONMENT_URL,process.env.SCALEKIT_CLIENT_ID,process.env.SCALEKIT_CLIENT_SECRET,)const actions = scalekit.actionsconst connector = 'mandrill'const identifier = 'user_123'// Generate an authorization link for the userconst { link } = await actions.getAuthorizationLink({ connectionName: connector, identifier })console.log('Authorize Mandrill (Mailchimp Transactional):', link)const rl = createInterface({ input: process.stdin, output: process.stdout })await rl.question('Press Enter after authorizing...')rl.close()// Make your first callconst result = await actions.executeTool({connector,identifier,toolName: 'mandrill_user_info_get',toolInput: {},})console.log(result)Terminal window npx tsx quickstart.mtsquickstart.py import osfrom scalekit import ScalekitClientfrom dotenv import load_dotenvload_dotenv()scalekit_client = ScalekitClient(env_url=os.getenv("SCALEKIT_ENVIRONMENT_URL"),client_id=os.getenv("SCALEKIT_CLIENT_ID"),client_secret=os.getenv("SCALEKIT_CLIENT_SECRET"),)actions = scalekit_client.actionsconnection_name = "mandrill"identifier = "user_123"# Generate an authorization link for the userlink_response = actions.get_authorization_link(connection_name=connection_name,identifier=identifier,)print("Authorize Mandrill (Mailchimp Transactional):", link_response.link)input("Press Enter after authorizing...")# Make your first callresult = actions.execute_tool(tool_input={},tool_name="mandrill_user_info_get",connection_name=connection_name,identifier=identifier,)print(result)Terminal window python quickstart.pyEach user opens the link once and enters their Mandrill (Mailchimp Transactional) credentials there. See Authorize a user for the full flow and statuses.
Tools
Pass the exact name toexecute_toolmandrill_allowlist_listList addresses on the allowlist, which are never added to the denylist automatically.Read-onlyList Allowlist
List addresses on the allowlist, which are never added to the denylist automatically. Returns an array with email, detail and created_at.
Inputs
emailstring- An optional email address or prefix to search by. Example: jane@example.com
mandrill_inbound_domain_checkCheck an inbound domain's MX records now.Read-onlyCheck Inbound Domain
Check an inbound domain's MX records now. Returns domain, created_at and valid_mx.
Inputs
domainstringrequired- An existing inbound domain. Example: mail.example.com
mandrill_inbound_domains_listList the domains configured to receive inbound email.Read-onlyList Inbound Domains
List the domains configured to receive inbound email. Returns an array with domain, created_at and valid_mx.
Inputs
This tool takes no inputs.
mandrill_inbound_routes_listList the mailbox routes for an inbound domain.Read-onlyList Inbound Routes
List the mailbox routes for an inbound domain. Returns an array with id, pattern and url.
Inputs
domainstring- The domain to check (required if phone is not provided) Example: mail.example.com
phonestring- The SMS program phone number (required if domain is not provided) Example: +15551234567
mandrill_message_content_getRetrieve the full content (subject, from, to, headers, HTML, text and attachments) of a recently sent message.Read-onlyGet Message Content
Retrieve the full content (subject, from, to, headers, HTML, text and attachments) of a recently sent message. Returns ts, _id, from_email, from_name, subject, to, tags, headers, text, html and attachments. Content is kept only for a few days.
Inputs
idstringrequired- Message ID (_id) of a recently sent message. Example: abc123abc123abc123abc123abc123
mandrill_message_info_getRetrieve the delivery details of one sent message.Read-onlyGet Message Info
Retrieve the delivery details of one sent message. Returns ts, _id, sender, template, subject, email, tags, opens, opens_detail, clicks, clicks_detail, state, metadata and smtp_events.
Inputs
idstringrequired- Message ID (_id) returned when the message was sent or by mandrill_messages_search. Example: abc123abc123abc123abc123abc123
mandrill_message_parseParse a raw MIME message into its parts without sending it.Read-onlyParse MIME Message
Parse a raw MIME message into its parts without sending it. Returns subject, from_email, from_name, to, headers, text, html, attachments and images.
Inputs
raw_messagestringrequired- The full MIME document of an email message. Example: From: orders@example.com To: jane@example.com Subject: Hi Hello
mandrill_messages_searchSearch recently sent messages (up to 90 days, depending on retention) by query, date range, tags, senders or API keys.Read-onlySearch Messages
Search recently sent messages (up to 90 days, depending on retention) by query, date range, tags, senders or API keys. Returns an array of messages with ts, _id, sender, template, subject, email, tags, opens, clicks, state, metadata and smtp_events. Use this to find messages. Use mandrill_message_info_get for one message's details.
Inputs
api_keysarray- An array of API keys to narrow the search to, will return messages sent by ANY of the keys. Example: ["Aq1Bc2De3Fg4Hi5Jk6Lm7"]
date_fromstring- Start date. Example: 2026-11-01
date_tostring- End date. Example: 2026-11-13
limitinteger- The maximum number of results to return, defaults to 100, 1000 is the maximum. Example: 100
querystring- Search terms to find matching messages. Example: email:jane@example.com AND tags:receipts
sendersarray- An array of sender addresses to narrow the search to, will return messages sent by ANY of the senders. Example: ["orders@example.com"]
tagsarray- An array of tag names to narrow the search to, will return messages that contain ANY of the tags. Example: ["password-reset"]
mandrill_messages_search_time_seriesCount sent messages matching a search, bucketed by hour.Read-onlySearch Message Statistics by Hour
Count sent messages matching a search, bucketed by hour. Returns an array of hourly stats with time, sent, hard_bounces, soft_bounces, rejects, complaints, unsubs, opens, unique_opens, clicks and unique_clicks.
Inputs
date_fromstring- Start date. Example: 2026-11-01
date_tostring- End date. Example: 2026-11-13
querystring- The search terms to find matching messages for. Example: email:jane@example.com AND tags:receipts
sendersarray- An array of sender addresses to narrow the search to, will return messages sent by ANY of the senders. Example: ["orders@example.com"]
tagsarray- An array of tag names to narrow the search to, will return messages that contain ANY of the tags. Example: ["password-reset"]
mandrill_metadata_fields_listList the custom metadata fields indexed for the account (used to search messages by metadata).Read-onlyList Metadata Fields
List the custom metadata fields indexed for the account (used to search messages by metadata). Returns an array with name, state and view_template.
Inputs
This tool takes no inputs.
mandrill_rejects_listList addresses on the denylist (rejects), which Mandrill will not send to, optionally for one address or subaccount.Read-onlyList Denylist
List addresses on the denylist (rejects), which Mandrill will not send to, optionally for one address or subaccount. Returns an array with email, reason (hard-bounce, soft-bounce, spam, unsub, custom), detail, created_at, expires_at, expired and sender.
Inputs
emailstring- An optional email address to search by. Example: jane@example.com
include_expiredboolean- Whether to include rejections that have already expired. Example: false
subaccountstring- An optional unique identifier for the subaccount to limit the denylist. Example: cust-123
mandrill_scheduled_messages_listList messages scheduled to be sent later, optionally only those to one recipient.Read-onlyList Scheduled Messages
List messages scheduled to be sent later, optionally only those to one recipient. Returns an array with _id, created_at, send_at, from_email, to and subject.
Inputs
tostring- Only scheduled messages to this recipient address. Example: jane@example.com
mandrill_sender_domain_checkCheck a sending domain's SPF and DKIM DNS records now.Read-onlyCheck Sender Domain
Check a sending domain's SPF and DKIM DNS records now. Returns domain, spf and dkim (each with valid, valid_after and error), verified_at and valid_signing.
Inputs
domainstringrequired- A domain name. Example: mail.example.com
mandrill_sender_domains_listList sending domains with their SPF, DKIM and verification status.Read-onlyList Sender Domains
List sending domains with their SPF, DKIM and verification status. Returns an array with domain, created_at, last_tested_at, spf, dkim, verified_at and valid_signing.
Inputs
This tool takes no inputs.
mandrill_sender_info_getGet detailed statistics for one sender address (today, last 7, 30, 60 and 90 days).Read-onlyGet Sender Statistics
Get detailed statistics for one sender address (today, last 7, 30, 60 and 90 days). Returns address, created_at, sent, hard_bounces, soft_bounces, rejects, complaints, unsubs, opens, clicks and stats.
Inputs
addressstringrequired- The email address of the sender. Example: orders@example.com
mandrill_sender_time_series_getGet hourly statistics for one sender address over the last 30 days.Read-onlyGet Sender Statistics by Hour
Get hourly statistics for one sender address over the last 30 days. Returns an array with time, sent, hard_bounces, soft_bounces, rejects, complaints, opens and clicks.
Inputs
addressstringrequired- The email address of the sender. Example: orders@example.com
mandrill_senders_listList the sender addresses that have sent through the account, with their statistics.Read-onlyList Senders
List the sender addresses that have sent through the account, with their statistics. Returns an array with address, created_at, sent, hard_bounces, soft_bounces, rejects, complaints, unsubs, opens, clicks, unique_opens and unique_clicks.
Inputs
This tool takes no inputs.
mandrill_subaccount_info_getRetrieve one subaccount with its statistics.Read-onlyGet Subaccount
Retrieve one subaccount with its statistics. Returns id, name, notes, custom_quota, status, reputation, sent_total, sent_hourly, hourly_quota and last_30_days.
Inputs
idstringrequired- The unique identifier of the subaccount to query. Example: 1
mandrill_subaccounts_listList the account's subaccounts, optionally filtered by ID prefix.Read-onlyList Subaccounts
List the account's subaccounts, optionally filtered by ID prefix. Returns an array with id, name, custom_quota, status, reputation, created_at, sent_total, sent_hourly and hourly_quota.
Inputs
qstring- An optional prefix to filter the subaccounts' ids and names. Example: cust
mandrill_tag_info_getGet detailed statistics for one tag (today, last 7, 30, 60 and 90 days).Read-onlyGet Tag Statistics
Get detailed statistics for one tag (today, last 7, 30, 60 and 90 days). Returns tag, sent, hard_bounces, soft_bounces, rejects, complaints, unsubs, opens, clicks and stats.
Inputs
tagstringrequired- An existing tag name. Example: password-reset
mandrill_tag_time_series_getGet hourly statistics for one tag over the last 30 days.Read-onlyGet Tag Statistics by Hour
Get hourly statistics for one tag over the last 30 days. Returns an array with time, sent, hard_bounces, soft_bounces, rejects, complaints, opens and clicks.
Inputs
tagstringrequired- An existing tag name. Example: password-reset
mandrill_template_info_getRetrieve one template, including its draft and published code.Read-onlyGet Template
Retrieve one template, including its draft and published code. Returns slug, name, labels, code, subject, from_email, from_name, text, publish_code, publish_subject and published_at.
Inputs
namestringrequired- The immutable name of an existing template. Example: order-shipped
mandrill_template_renderRender a template's HTML with editable content and merge variables, without sending.Read-onlyRender Template
Render a template's HTML with editable content and merge variables, without sending. Returns html, the rendered result.
Inputs
template_contentarrayrequired- Content for the template's editable regions, each with name and content. Send an empty array when there are none. Example: [{"name": "header", "content": "<h1>Hi</h1>"}]
template_namestringrequired- Name (slug) of the Mandrill template. Example: order-shipped
merge_varsarray- Optional merge variables to use for injecting merge field content. If this is not provided, no merge fields will be replaced. Example: [{"name": "FNAME", "content": "Jane"}]
mandrill_template_time_series_getGet hourly sending statistics for one template over the last 30 days.Read-onlyGet Template Statistics
Get hourly sending statistics for one template over the last 30 days. Returns an array with time, sent, hard_bounces, soft_bounces, rejects, complaints, unsubs, opens, unique_opens, clicks and unique_clicks.
Inputs
namestringrequired- The name of an existing template. Example: order-shipped
mandrill_templates_listList the Mandrill templates in the account, optionally by label.Read-onlyList Templates
List the Mandrill templates in the account, optionally by label. Returns an array of templates with slug, name, labels, subject, from_email, from_name, code, publish_code, published_at, created_at and updated_at. Use mandrill_template_info_get for one template.
Inputs
labelstring- An optional label to filter the templates. Example: receipts
mandrill_tracking_domain_checkCheck a tracking domain's CNAME record now.Read-onlyCheck Tracking Domain
Check a tracking domain's CNAME record now. Returns domain, cname (valid, valid_after, error) and valid_tracking.
Inputs
domainstringrequired- An existing tracking domain name. Example: mail.example.com
mandrill_tracking_domains_listList custom click and open tracking domains with their CNAME status.Read-onlyList Tracking Domains
List custom click and open tracking domains with their CNAME status. Returns an array with domain, created_at, last_tested_at, cname (valid, valid_after, error) and valid_tracking.
Inputs
This tool takes no inputs.
mandrill_user_info_getRetrieve the account's username, reputation, hourly quota, backlog and sending statistics.Read-onlyGet Account Info
Retrieve the account's username, reputation, hourly quota, backlog and sending statistics. Returns username, created_at, public_id, reputation, hourly_quota, backlog and stats (today, last 7, 30, 60, 90 days, all time).
Inputs
This tool takes no inputs.
mandrill_user_pingCheck that the API key works.Read-onlyPing
Check that the API key works. Returns PING with the value PONG!.
Inputs
This tool takes no inputs.
mandrill_webhook_info_getRetrieve one webhook.Read-onlyGet Webhook
Retrieve one webhook. Returns id, url, description, auth_key, events, created_at, last_sent_at, batches_sent, events_sent and last_error.
Inputs
idintegerrequired- The unique identifier of a webhook belonging to this account. Example: 1
mandrill_webhooks_listList the webhooks configured for the account.Read-onlyList Webhooks
List the webhooks configured for the account. Returns an array with id, url, description, auth_key, events, created_at, last_sent_at, batches_sent, events_sent and last_error.
Inputs
This tool takes no inputs.
mandrill_allowlist_addAdd an address to the allowlist so bounces never denylist it.WriteAdd to Allowlist
Add an address to the allowlist so bounces never denylist it. Returns email and whether it was added.
- Idempotent
Inputs
emailstringrequired- An email address to add to the allowlist. Example: jane@example.com
commentstring- An optional description of why the email was added to the allowlist. Example: Requested removal
mandrill_inbound_domain_addAdd a domain to receive inbound email.WriteAdd Inbound Domain
Add a domain to receive inbound email. Point its MX records at Mandrill. Returns domain, created_at and valid_mx.
- Idempotent
Inputs
domainstringrequired- A domain name; Validation: strip_tags, required. Example: mail.example.com
mandrill_inbound_route_addRoute inbound email whose local part matches a pattern (for example support-*) on an inbound domain to your webhook URL.WriteAdd Inbound Route
Route inbound email whose local part matches a pattern (for example support-*) on an inbound domain to your webhook URL. Returns the route's id, pattern and url.
Inputs
urlstringrequired- The webhook URL where the inbound messages will be published. Example: https://example.com/mandrill/webhook
domainstring- An existing inbound domain (required if phone is not provided) Example: inbound.example.com
patternstring- For email: the mailbox pattern (e.g., "mailbox-*"). For SMS: not used, the phone number is the pattern. Example: support-*
phonestring- The SMS program phone number - the TO number that receives inbound SMS (required if domain is not provided) Example: +15551234567
mandrill_inbound_route_updateChange an inbound route's pattern or URL.WriteUpdate Inbound Route
Change an inbound route's pattern or URL. Returns the updated route.
- Idempotent
Inputs
idstringrequired- The unique identifier of an existing mailbox route. Example: 7.a1b2c3d4e5f6a7b8
patternstring- For email: The search pattern that the mailbox name should match. For SMS: the sender's phone number (FROM number). Null to leave unchanged. Example: support-*
urlstring- The webhook URL where the inbound messages will be published; Validation: webhookexists. Example: https://example.com/mandrill/webhook
mandrill_message_sendSend a transactional email with inline HTML or text content to one or more recipients.WriteSend Email
Send a transactional email with inline HTML or text content to one or more recipients. Returns an array with one result per recipient: email, status (sent, queued, scheduled, rejected or invalid), reject_reason and _id (the message ID). Use this for inline content. Use mandrill_message_send_template to send a stored template. Prerequisite: the from domain should be verified in Mandrill (see mandrill_sender_domains_list).
Inputs
toarrayrequired- Recipients, each an object with email, an optional name, and an optional type (to, cc or bcc; defaults to to) Example: [{"email": "jane@example.com", "name": "Jane Doe", "type": "to"}]
asyncboolean- Enable a background sending mode that is optimized for bulk sending. In async mode, messages/send will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Example: false
attachmentsarray- Attachments, each with type (MIME type), name (file name) and content (the file as base64) Example: [{"type": "application/pdf", "name": "invoice.pdf", "content": "JVBERi0xLjQK"}]
auto_htmlboolean- Whether or not to automatically generate an HTML part for messages that are not given HTML. Example: true
auto_textboolean- Whether or not to automatically generate a text part for messages that are not given text. Example: true
bcc_addressstring- An optional address to receive an exact copy of each recipient's email. Example: archive@example.com
from_emailstring- The sender email address. Example: orders@example.com
from_namestring- Optional from name to be used. Example: Acme Orders
global_merge_varsarray- Global merge variables to use for all recipients. You can override these per recipient. Example: [{"name": "ORDERID", "content": "A1001"}]
google_analytics_campaignstring- Optional string indicating the value to set for the utm_campaign tracking parameter. If this isn't provided the email's from address will be used instead. Example: order-emails
google_analytics_domainsarray- An array of strings indicating for which any matching URLs will automatically have Google Analytics parameters appended to their query string automatically. Example: ["example.com"]
headersobject- Optional extra headers to add to the message (most headers are allowed) Example: {"Reply-To": "help@example.com"}
htmlstring- The full HTML content to be sent. Example: <p>Hi *|FNAME|*, your order shipped.</p>
imagesarray- Inline images, each with type (an image/ MIME type), name (the Content-ID used as cid:name in the HTML) and content (base64) Example: [{"type": "image/png", "name": "logo", "content": "iVBORw0KGgo="}]
importantboolean- Whether or not this message is important, and should be delivered ahead of non-important messages. Example: true
inline_cssboolean- Whether or not to automatically inline all CSS styles provided in the message HTML - only for HTML documents less than 256KB in size. Example: true
ip_poolstring- The name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead. Example: Main Pool
mergeboolean- Whether to evaluate merge tags in the message. Will automatically be set to true if either merge_vars or global_merge_vars are provided. Example: true
merge_languagestring- The merge tag language to use when evaluating merge tags, either mailchimp or handlebars. Example: mailchimpone of
mailchimphandlebars merge_varsarray- Per-recipient merge variables that override global_merge_vars. Each item has rcpt (the recipient email) and vars (a list of name and content pairs) Example: [{"rcpt": "jane@example.com", "vars": [{"name": "FNAME", "content": "Jane"}]}]
metadataobject- Metadata an associative array of user metadata. Mandrill will store this metadata and make it available for retrieval. In addition, you can select up to 10 metadata fields to index and make searchable using the Mandrill search api. Example: {"order_id": "A1001"}
preserve_recipientsboolean- Whether or not to expose all recipients in to "To" header for each email. Example: true
recipient_metadataarray- Per-recipient metadata. Each item has rcpt (the recipient email) and values (an object of metadata) Example: [{"rcpt": "jane@example.com", "values": {"user_id": 42}}]
return_path_domainstring- A custom domain to use for the messages's return-path. Example: bounce.example.com
send_atstring- When to send, as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. Scheduling needs a paid account with prepaid credit; leave empty to send now. Example: 2026-11-20 09:00:00
signing_domainstring- A custom domain to use for SPF/DKIM signing instead of mandrill (for "via" or "on behalf of" in email clients) Example: mail.example.com
subaccountstring- The unique id of a subaccount for this message - must already exist or will fail with an error. Example: cust-123
subjectstring- The message subject. Example: Your order has shipped
tagsarray- An array of string to tag the message with. Stats are accumulated using tags, though we only store the first 100 we see, so this should not be unique or change frequently. Tags should be 50 characters or less. Any tags starting with an underscore are reserved for internal use and will cause errors. Example: ["order-shipped"]
textstring- Optional full text content to be sent. Example: Hi *|FNAME|*, your order shipped.
track_clicksboolean- Whether or not to turn on click tracking for the message. Example: true
track_opensboolean- Whether or not to turn on open tracking for the message. Example: true
tracking_domainstring- A custom domain to use for tracking opens and clicks instead of mandrillapp.com. Example: click.example.com
url_strip_qsboolean- Whether or not to strip the query string from URLs when aggregating tracked URL data. Example: true
view_content_linkboolean- Set to false to remove content logging for sensitive emails. Example: true
mandrill_message_send_rawSend a complete pre-built MIME message, optionally overriding the sender and recipients.WriteSend Raw MIME Email
Send a complete pre-built MIME message, optionally overriding the sender and recipients. Returns an array with one result per recipient: email, status (sent, queued, scheduled, rejected or invalid), reject_reason and _id (the message ID).
Inputs
raw_messagestringrequired- The full MIME document of an email message. Example: From: orders@example.com To: jane@example.com Subject: Hi Hello
asyncboolean- Enable a background sending mode that is optimized for bulk sending. In async mode, messages/sendRaw will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Example: false
from_emailstring- Optionally define the sender address - otherwise we'll use the address found in the provided headers. Example: orders@example.com
from_namestring- Optionally define the sender alias. Example: Acme Orders
ip_poolstring- The name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead. Example: Main Pool
return_path_domainstring- A custom domain to use for the messages's return-path. Example: example.com
send_atstring- When to send, as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. Scheduling needs a paid account with prepaid credit; leave empty to send now. Example: 2026-11-20 09:00:00
toarray- Recipients to send to instead of the addresses in the MIME headers. Example: ["jane@example.com"]
mandrill_message_send_templateSend a transactional email using a stored Mandrill template, filling its editable regions and merge tags.WriteSend Email with Template
Send a transactional email using a stored Mandrill template, filling its editable regions and merge tags. Returns an array with one result per recipient: email, status (sent, queued, scheduled, rejected or invalid), reject_reason and _id (the message ID). Use this for stored templates (see mandrill_templates_list). Use mandrill_message_send for inline content.
Inputs
template_contentarrayrequired- Content for the template's editable regions (mc:edit), each an object with name and content. Send an empty array when the template has none. Example: [{"name": "header", "content": "<h1>Order shipped</h1>"}]
template_namestringrequired- Name (slug) of the Mandrill template. Example: order-shipped
toarrayrequired- Recipients, each an object with email, an optional name, and an optional type (to, cc or bcc; defaults to to) Example: [{"email": "jane@example.com", "name": "Jane Doe", "type": "to"}]
asyncboolean- Enable a background sending mode that is optimized for bulk sending. In async mode, messages/send will immediately return a status of "queued" for every recipient. To handle rejections when sending in async mode, set up a webhook for the 'reject' event. Example: false
attachmentsarray- Attachments, each with type (MIME type), name (file name) and content (the file as base64) Example: [{"type": "application/pdf", "name": "invoice.pdf", "content": "JVBERi0xLjQK"}]
auto_htmlboolean- Whether or not to automatically generate an HTML part for messages that are not given HTML. Example: true
auto_textboolean- Whether or not to automatically generate a text part for messages that are not given text. Example: true
bcc_addressstring- An optional address to receive an exact copy of each recipient's email. Example: archive@example.com
from_emailstring- The sender email address. Example: orders@example.com
from_namestring- Optional from name to be used. Example: Acme Orders
global_merge_varsarray- Global merge variables to use for all recipients. You can override these per recipient. Example: [{"name": "ORDERID", "content": "A1001"}]
google_analytics_campaignstring- Optional string indicating the value to set for the utm_campaign tracking parameter. If this isn't provided the email's from address will be used instead. Example: order-emails
google_analytics_domainsarray- An array of strings indicating for which any matching URLs will automatically have Google Analytics parameters appended to their query string automatically. Example: ["example.com"]
headersobject- Optional extra headers to add to the message (most headers are allowed) Example: {"Reply-To": "help@example.com"}
htmlstring- Optional full HTML content to be sent if not in template. Example: <p>Hi *|FNAME|*, your order shipped.</p>
imagesarray- Inline images, each with type (an image/ MIME type), name (the Content-ID used as cid:name in the HTML) and content (base64) Example: [{"type": "image/png", "name": "logo", "content": "iVBORw0KGgo="}]
importantboolean- Whether or not this message is important, and should be delivered ahead of non-important messages. Example: true
inline_cssboolean- Whether or not to automatically inline all CSS styles provided in the message HTML - only for HTML documents less than 256KB in size. Example: true
ip_poolstring- The name of the dedicated ip pool that should be used to send the message. If you do not have any dedicated IPs, this parameter has no effect. If you specify a pool that does not exist, your default pool will be used instead. Example: Main Pool
mergeboolean- Whether to evaluate merge tags in the message. Will automatically be set to true if either merge_vars or global_merge_vars are provided. Example: true
merge_languagestring- The merge tag language to use when evaluating merge tags, either mailchimp or handlebars. Example: mailchimpone of
mailchimphandlebars merge_varsarray- Per-recipient merge variables that override global_merge_vars. Each item has rcpt (the recipient email) and vars (a list of name and content pairs) Example: [{"rcpt": "jane@example.com", "vars": [{"name": "FNAME", "content": "Jane"}]}]
metadataobject- Metadata an associative array of user metadata. Mandrill will store this metadata and make it available for retrieval. In addition, you can select up to 10 metadata fields to index and make searchable using the Mandrill search api. Example: {"order_id": "A1001"}
preserve_recipientsboolean- Whether or not to expose all recipients in to "To" header for each email. Example: true
recipient_metadataarray- Per-recipient metadata. Each item has rcpt (the recipient email) and values (an object of metadata) Example: [{"rcpt": "jane@example.com", "values": {"user_id": 42}}]
return_path_domainstring- A custom domain to use for the messages's return-path. Example: bounce.example.com
send_atstring- When to send, as a UTC timestamp in YYYY-MM-DD HH:MM:SS format. Scheduling needs a paid account with prepaid credit; leave empty to send now. Example: 2026-11-20 09:00:00
signing_domainstring- A custom domain to use for SPF/DKIM signing instead of mandrill (for "via" or "on behalf of" in email clients) Example: mail.example.com
subaccountstring- The unique id of a subaccount for this message - must already exist or will fail with an error. Example: cust-123
subjectstring- The message subject. Example: Your order has shipped
tagsarray- An array of string to tag the message with. Stats are accumulated using tags, though we only store the first 100 we see, so this should not be unique or change frequently. Tags should be 50 characters or less. Any tags starting with an underscore are reserved for internal use and will cause errors. Example: ["order-shipped"]
textstring- Optional full text content to be sent. Example: Hi *|FNAME|*, your order shipped.
track_clicksboolean- Whether or not to turn on click tracking for the message. Example: true
track_opensboolean- Whether or not to turn on open tracking for the message. Example: true
tracking_domainstring- A custom domain to use for tracking opens and clicks instead of mandrillapp.com. Example: click.example.com
url_strip_qsboolean- Whether or not to strip the query string from URLs when aggregating tracked URL data. Example: true
view_content_linkboolean- Set to false to remove content logging for sensitive emails. Example: true
mandrill_metadata_field_addAdd a custom metadata field to index on sent messages.WriteAdd Metadata Field
Add a custom metadata field to index on sent messages. Returns name, state and view_template.
Inputs
namestringrequired- Metadata field name to index. Example: order_id
view_templatestring- Mustache template to control how the metadata is rendered in your activity log. Example: {{name}}
mandrill_reject_addAdd an address to the denylist so Mandrill stops sending to it.WriteAdd to Denylist
Add an address to the denylist so Mandrill stops sending to it. Returns email and added (true when it was not already listed).
- Idempotent
Inputs
emailstringrequired- An email address to block. Example: jane@example.com
commentstring- An optional comment describing the rejection. Example: Requested removal
subaccountstring- An optional unique identifier for the subaccount to limit the denylist entry. Example: cust-123
mandrill_scheduled_message_rescheduleChange when a scheduled message will be sent.WriteReschedule Message
Change when a scheduled message will be sent. Returns the message's _id, created_at, send_at, from_email, to and subject.
- Idempotent
Inputs
idstringrequired- Scheduled message ID from mandrill_scheduled_messages_list. Example: abc123abc123abc123abc123abc123
send_atstringrequired- New send time, UTC, YYYY-MM-DD HH:MM:SS. Example: 2026-11-21 09:00:00
mandrill_sender_domain_addAdd a sending domain to the account.WriteAdd Sender Domain
Add a sending domain to the account. Returns domain, spf, dkim, verified_at and valid_signing. Next verify it with mandrill_sender_domain_verify.
- Idempotent
Inputs
domainstringrequired- A domain name. Example: mail.example.com
mandrill_sender_domain_verifySend a verification email to a mailbox at a sending domain to prove ownership.WriteVerify Sender Domain
Send a verification email to a mailbox at a sending domain to prove ownership. Returns status (sent or already_verified) and domain.
Inputs
domainstringrequired- Domain name at which you can receive email. Example: mail.example.com
mailboxstringrequired- A mailbox at the domain where the verification email should be sent. Example: postmaster
mandrill_template_addCreate a template.WriteCreate Template
Create a template. It stays a draft unless publish is true. Returns the new template's slug, name, code and publish fields.
Inputs
namestringrequired- Template name; its slug is derived from it and used to send. Example: Order Shipped
codestring- The HTML code for the template with mc:edit attributes for the editable elements. Example: <p>Hi *|FNAME|*, your order *|ORDERID|* shipped.</p>
from_emailstring- A default sending address for emails sent using this template. Example: orders@example.com
from_namestring- A default from name to be used. Example: Acme Orders
labelsarray- An optional array of up to 10 labels to use for filtering templates. Example: ["receipts"]
publishboolean- Set to false to add a draft template without publishing. Example: true
subjectstring- A default subject line to be used. Example: Your order has shipped
textstring- A default text part to be used when sending with this template. Example: Hi *|FNAME|*, your order shipped.
mandrill_template_publishPublish a template's current draft so sends use it.WritePublish Template
Publish a template's current draft so sends use it. Returns the template with its new publish fields.
- Idempotent
Inputs
namestringrequired- The immutable name of an existing template. Example: order-shipped
mandrill_template_updateUpdate a template's draft code, subject, sender, text or labels, and optionally publish it.WriteUpdate Template
Update a template's draft code, subject, sender, text or labels, and optionally publish it. Returns the updated template.
- Idempotent
Inputs
namestringrequired- The immutable name of an existing template. Example: order-shipped
codestring- The new code for the template. Example: <p>Hi *|FNAME|*, your order *|ORDERID|* shipped.</p>
from_emailstring- The new default sending address. Example: orders@example.com
from_namestring- The new default from name. Example: Acme Orders
labelsarray- An optional array of up to 10 labels to use for filtering templates. Example: ["receipts"]
publishboolean- Set to false to update the draft version of the template without publishing. Example: true
subjectstring- The new default subject line. Example: Your order has shipped
textstring- The new default text part to be used. Example: Hi *|FNAME|*, your order shipped.
mandrill_tracking_domain_addAdd a custom tracking domain.WriteAdd Tracking Domain
Add a custom tracking domain. Point its CNAME at Mandrill, then check it with mandrill_tracking_domain_check. Returns domain, cname and valid_tracking.
- Idempotent
Inputs
domainstringrequired- A domain name. Example: mail.example.com
mandrill_webhook_addAdd a webhook that receives batches of message events (send, deferral, hard_bounce, soft_bounce, open, click, spam, unsub, reject).WriteAdd Webhook
Add a webhook that receives batches of message events (send, deferral, hard_bounce, soft_bounce, open, click, spam, unsub, reject). Returns the webhook's id, url, events and auth_key (used to verify signatures).
Inputs
urlstringrequired- The URL to POST batches of events. Example: https://example.com/mandrill/webhook
descriptionstring- An optional description of the webhook. Example: Order events
eventsarray- An optional list of events that will be posted to the webhook. Example: ["send", "hard_bounce", "open", "click"]
mandrill_webhook_updateChange a webhook's URL, description or events.WriteUpdate Webhook
Change a webhook's URL, description or events. Returns the updated webhook.
- Idempotent
Inputs
idnumberrequired- The unique identifier of a webhook belonging to this account. Example: 1
urlstringrequired- The URL to POST batches of events. Requires webhook to exist. Example: https://example.com/mandrill/webhook
descriptionstring- An optional description of the webhook. Example: Order events
eventsarray- An optional list of events that will be posted to the webhook. Example: ["send", "hard_bounce"]
mandrill_allowlist_deleteRemove an address from the allowlist.DestructiveRemove from Allowlist
Remove an address from the allowlist. Returns email and deleted.
- Idempotent
Inputs
emailstringrequired- The email address to remove from the allowlist. Example: jane@example.com
mandrill_inbound_domain_deleteDelete an inbound domain and its routes.DestructiveDelete Inbound Domain
Delete an inbound domain and its routes. Returns the deleted domain.
- Idempotent
Inputs
domainstringrequired- An existing inbound domain. Example: mail.example.com
mandrill_inbound_route_deleteDelete an inbound route.DestructiveDelete Inbound Route
Delete an inbound route. Returns the deleted route.
- Idempotent
Inputs
idstringrequired- The unique identifier of an existing route. Example: 7.a1b2c3d4e5f6a7b8
mandrill_metadata_field_deleteDelete a custom metadata field.DestructiveDelete Metadata Field
Delete a custom metadata field. Returns name, state and view_template.
- Idempotent
Inputs
namestringrequired- Metadata field name to delete. Example: order_id
mandrill_reject_deleteRemove an address from the denylist so Mandrill can send to it again.DestructiveRemove from Denylist
Remove an address from the denylist so Mandrill can send to it again. Returns email and deleted.
- Idempotent
Inputs
emailstringrequired- An email address. Example: jane@example.com
subaccountstring- An optional unique identifier for the subaccount to limit the denylist deletion. Example: cust-123
mandrill_scheduled_message_cancelCancel a scheduled message before it is sent.DestructiveCancel Scheduled Message
Cancel a scheduled message before it is sent. Returns the cancelled message's _id, created_at, send_at, from_email, to and subject.
Inputs
idstringrequired- Scheduled message ID from mandrill_scheduled_messages_list. Example: abc123abc123abc123abc123abc123
mandrill_sender_domain_deleteRemove a sending domain from the account.DestructiveDelete Sender Domain
Remove a sending domain from the account. Returns the deleted domain's details.
- Idempotent
Inputs
domainstringrequired- The domain name to delete. Example: mail.example.com
mandrill_tag_deleteDelete a tag and its statistics.DestructiveDelete Tag
Delete a tag and its statistics. Messages are not affected; the tag is recreated if used again. Returns the deleted tag's statistics.
- Idempotent
Inputs
tagstringrequired- A tag name. Example: password-reset
mandrill_template_deleteDelete a template.DestructiveDelete Template
Delete a template. Returns the deleted template.
- Idempotent
Inputs
namestringrequired- The immutable name of an existing template. Example: order-shipped
mandrill_webhook_deleteDelete a webhook.DestructiveDelete Webhook
Delete a webhook. Returns the deleted webhook.
- Idempotent
Inputs
idintegerrequired- The unique identifier of a webhook belonging to this account. Example: 1
No tools match.