Draft email
draft_emailRead-onlyIdempotent
Drafts one email the user sends themselves. Use when the user wants to email someone or needs an .eml file for Apple Mail, Outlook or Thunderbird. Only body is required. Leave to empty for a draft with no recipient. Returns a mailto: link that opens the email app with recipient, subject and body filled in, plus the full .eml draft text. If the link is over 2,000 characters, warning says so: give the user the .eml text instead. Nothing is sent or stored. Do not use for Instagram, LinkedIn, SMS or bulk email: Send Out cannot send those, so tell the user and offer an email draft instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cc | No | Optional CC email address or comma-separated addresses. | |
| to | No | Recipient address, or several separated by commas, such as "alex@example.com, sam@example.com". Leave empty for a draft with no recipient that the user fills in. | |
| bcc | No | Optional BCC email address or comma-separated addresses. | |
| body | Yes | Email body as plain text with line breaks (at most 50,000 characters), such as "Hi team, phase 1 is done and ready for review." | |
| subject | No | Email subject line, such as "Sprint review notes". Optional. | |
| filename | No | Optional .eml filename (without or with .eml). |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| notes | Yes | Short notes to pass on to the user, including any warning. | |
| status | Yes | Always ok when the draft was made. Bad input returns an error instead. | |
| warning | No | Warning if the mailto URL exceeds safe client length limits. | |
| filename | Yes | Suggested file name for the .eml file. | |
| mailto_url | Yes | RFC 6068 mailto URI for instant client-side draft opening. | |
| url_length | Yes | Total length of the mailto URL. | |
| eml_content | Yes | RFC 822/5322 .eml MIME draft text ready to save or open. | |
| character_count | Yes | Length of the email body in characters. |