Search Messages
mandrill.search_messages
ActionEmailconnection required
Calls the Mandrill API with the connection's credentials.
Search the messages the account sent in the last 30 days by query, date, tag or sender.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Mandrill
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- base_url, from_email, from_name, subaccount, ip_pool
- Resolved by
- config.connection_id, else node.connection_id
Configuration
6 fields, none required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
query Search terms, in Mandrill's search syntax (email:ada@x.io, subject:receipt, full_email:…). | string | No | — | — | email:ada@example.com |
date_from Earliest send date to include, as YYYY-MM-DD. | string | No | — | matches \d{4}-\d{2}-\d{2} | 2026-09-01 |
date_to Latest send date to include, as YYYY-MM-DD. | string | No | — | matches \d{4}-\d{2}-\d{2} | 2026-09-30 |
tags Narrow the search to these tags; a comma-separated list is accepted. | array | No | — | array of string | — |
senders Narrow the search to these sender addresses; a comma-separated list is accepted. | array | No | — | array of string | — |
limit Most messages to return. Mandrill defaults to 100 and caps the call at 1000. | integer | No | 100 | 1–1000 | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"date_from": "2026-09-01",
"date_to": "2026-09-30",
"limit": 100,
"query": "email:ada@example.com"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
items The matching messages, newest first. | array | — |
count How many messages were returned. | number | — |
{
"count": 0,
"items": []
}Notes
- Mandrill only indexes the last 30 days; older mail is not searchable.
See Search Messages run in a workflow.
In a technical demo we add the Mandrill connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.