send_email
Destructive
Send an outbound email directly through Proton Mail Bridge SMTP. Supports attachments, Markdown, priority, read receipts, and a cancelable delay window for one-shot messages.
Instructions
Compose and send a new outbound email through Proton Bridge SMTP. Use for one-shot messages that need no review. Prefer create_draft when you want to save and review before sending, or reply_to_email when responding to an existing message. Fails if PROTONMAIL_ALLOW_SEND is false or if Bridge SMTP is unreachable. If PROTONMAIL_SEND_DELAY_SECONDS is set, this queues the send instead of sending immediately and returns a cancelable id — call cancel_send within the window to abort. Otherwise returns delivery confirmation immediately.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | CC recipient email addresses, comma-separated. | |
| to | Yes | Recipient email addresses, comma-separated. | |
| bcc | No | BCC recipient email addresses, comma-separated. | |
| body | No | Email body content (plain text). Required unless markdownBody is provided. | |
| dryRun | No | Preview the full recipient set and validate without sending. | |
| isHtml | No | Whether body should be sent as HTML (ignored when markdownBody is provided). | |
| replyTo | No | Optional reply-to email address. | |
| subject | Yes | Email subject. | |
| fromName | No | Optional display name for the From header (e.g. 'Alice'). Does not change the sending address. | |
| priority | No | SMTP priority header. | |
| confirmed | No | Set to true to confirm this irreversible send when PROTONMAIL_CONFIRM_DESTRUCTIVE is enabled. | |
| attachments | No | Attachments with base64 encoded content. | |
| markdownBody | No | Email body in Markdown. When provided, rendered to HTML with body as plain-text fallback; takes precedence over body+isHtml. | |
| sanitizeHtml | No | Strip scripts, event handlers, and remote image beacons from HTML before delivery. Defaults to true when body is HTML. | |
| appendSignature | No | Append PROTONMAIL_SIGNATURE (if configured) to the body. Set false to send without it for this one message. | |
| undoWindowSeconds | No | Override PROTONMAIL_SEND_DELAY_SECONDS for this one send: queue it for this many seconds (cancelable via cancel_send) instead of the server's configured default. 0 sends immediately even if the server has a default window configured. Same caveat as the server default: only fires while this server process stays running. | |
| requestReadReceipt | No | Request a read receipt (MDN) via a Disposition-Notification-To header. Most mail clients ask the recipient before honoring it — this is a request, not a guarantee. |