Email a supplier or carrier
agent_outreachIdempotent
Email outside addresses (suppliers, carriers). to is a string email, { email }, or { emails } (max 5). Not to=all and not a Hub user_id / role — those are agent_notify. Linked agents set Reply-To to an org member (default OWNER). No action buttons. Channel is email.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Outside address(es): a string email, { email }, or { emails } (max 5). Not to=all and not a Hub user_id / role — those are agent_notify. | |
| body | Yes | Plain-text body, max 4000 characters. URLs stay escaped text, not buttons. | |
| title | Yes | Subject line, max 120 characters | |
| channel | No | Delivery channel. Email only — omit or pass email | |
| dry_run | No | If true, resolve recipients and from-address without sending or storing | |
| agent_id | Yes | Authenticated agent sending the note | |
| order_id | No | Optional order correlation | |
| reply_to | No | Linked only: who receives replies. { email } or { role } matching a member. Omit to default to the OWNER. Unlinked agents have no Reply-To. | |
| search_id | No | Optional search correlation | |
| session_token | No | Session token from agent_authenticate — required whenever agent_id is passed | |
| idempotency_key | No | Replay key — same agent + key returns the original outreach_id without sending again |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | ||
| hint | No | ||
| next | No | ||
| error | No | ||
| detail | No | ||
| failed | No | ||
| channel | No | ||
| dry_run | No | ||
| reply_to | No | ||
| delivered | No | ||
| recipients | No | ||
| outreach_id | No | ||
| idempotent_replay | No |