Get outgoing email
get_outgoing_emailCheck the delivery status of a previously queued email to confirm if it was sent, including delivery attempts and error codes, without sending again.
Instructions
Reports what became of a message you queued with send_email, reply_to_email, or forward_email: how far it has got, how many delivery attempts it has taken, what a mail server has said about each person it is addressed to, and the error code it stopped on if it stopped. Call this instead of sending again when you are unsure whether a send went through — a second send is a second message in somebody's mailbox and cannot be recalled. It reads a durable record this deployment already holds and speaks to no mail server, so the answer is as fresh as the last delivery attempt rather than a live check with the provider. You can only read back a message you queued yourself, and a message queued by anybody else reads as not found. There is no way to list what a mailbox has sent: this tool answers about one identifier at a time and nothing here enumerates. The answer says nothing about the message itself — no subject, no body, no attachments.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| outgoingEmailId | Yes | The identifier of the queued message, exactly as the sending tool returned it in outgoingEmailId. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | How far this message has got. | |
| queuedAt | Yes | When the send was first written down, as an ISO 8601 timestamp. | |
| accountId | Yes | The configured MailFathom account identifier the message is sent as. | |
| recipients | Yes | One entry per person the message is addressed to, in the order the headers name them. These are the addresses the send named and no others. | |
| failureCode | No | The five-digit MailFathom error code of the failure the last delivery attempt ended in, or absent while no attempt has failed. It is the same code a failed call reports, and it can be present on a message that later succeeds. | |
| attemptCount | Yes | How many delivery attempts have been made for this message. It is counted before each attempt rather than after it, so a message being attempted right now already shows that attempt. | |
| outgoingEmailId | Yes | The stable identifier of the message, the same value the sending tool answered with. |