Reply to a received email
reply_to_emailSend a threaded reply to a received email, setting In-Reply-To and References and applying the same send checks as a new message.
Instructions
Purpose: reply to one received email. Sets In-Reply-To and References so the conversation threads, and runs every send check a new send runs. NOT for: a new conversation (send_email), or reading the original (get_received_email). The recipient is the first Reply-To address, else the first From address; any other addresses in those headers are left off, so pass them as cc if they should get the reply. from defaults to the address that received it. Returns: the outbound message id and its status. Delivery happens after; get_email has the outcome. Refusals are the same as send_email: domain_not_verified, suppressed_recipient, agent_budget_exceeded. Addresses ending in @simulator.agentisend.com cost nothing. Sending twice is sending twice: pass an idempotency_key and a retry returns the first message id instead of a second email.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"received_id": "<received_id>"
},
"name": "reply_to_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Carbon-copy addresses — one string or a list. | |
| bcc | No | Blind carbon-copy addresses — one string or a list. | |
| from | No | Sender address. Defaults to the address the original mail was delivered to. | |
| html | No | HTML body. Provide html or text. | |
| text | No | Plain-text body. Provide html or text. | |
| subject | No | Subject line. Defaults to Re: plus the original subject. | |
| received_id | Yes | The id from list_received_emails of the mail you are answering. | |
| idempotency_key | No | Your own key for this action. Retrying with the same key returns the first result instead of doing it twice — send one whenever a retry could double the effect. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | No | Identifier. | |
| error | No | Present instead of the fields above when the call was refused: code, message, fix, docs_url, retryable and, when waiting helps, retry_after_seconds. | |
| status | No | The message status. |