Search Inbound Messages
postmark.search_inbound_messages
ActionEmailconnection required
Calls the Postmark API with the connection's credentials.
Search the messages Postmark received for this server's inbound address, by sender, recipient, subject, mailbox hash or date range.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Postmark
- Secret shape
- the server API token, or {"server_token": "…"}
- Config it needs
- message_stream, from_address, base_url
- Resolved by
- config.connection_id, else node.connection_id
Configuration
10 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 |
|---|---|---|---|---|---|
count How many messages to return in one page. Postmark's maximum is 500. | number | No | 50 | 1–500 | — |
offset How many records to skip before the page starts, for paging through results. | number | No | 0 | 0–1000000 | — |
recipient Only records for this recipient address. Postmark matches it as a prefix. | string | No | — | — | — |
from_email Only messages from this sender address. | string | No | — | email format | — |
tag Only records whose message carried this Postmark tag. | string | No | — | — | — |
subject Only messages whose subject contains this text. | string | No | — | — | — |
mailbox_hash Only messages addressed to this mailbox hash — the part after the + in the inbound address, which is how a reply is tied back to a record. | string | No | — | — | — |
status Only messages in this inbound processing state, e.g. blocked or processed. | string | No | — | — | — |
fromdate Only records from this date/time onward, as 2021-01-01 or 2021-01-01T12:00:00. Postmark interprets it in US Eastern time. | string | No | — | — | — |
todate Only records up to this date/time, as 2021-01-01 or 2021-01-01T12:00:00. Postmark interprets it in US Eastern time. | string | No | — | — | — |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"count": 50,
"offset": 0
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
items The records on this page, exactly as Postmark returned them. | array | — |
count How many records are on this page. | number | — |
total_count How many records match the filter in total, across every page. | number | — |
{
"count": 0,
"items": [],
"total_count": 0
}See Search Inbound Messages run in a workflow.
In a technical demo we add the Postmark connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.