Send email
send_emailSend an email to the signed-in user at their own account email address. Use this when the user asks to be sent something — 'email me this', 'send myself a reminder', 'send me that summary as an email'. The recipient is fixed to their own address and cannot be changed. To write an email to anyone else, use create_gmail_draft instead — it drafts in their Gmail without sending. Compose a short, specific subject line yourself if the user didn't give one.
The body is Markdown, rendered into the YouSpot email template before sending: '## ' subheadings, '- ' bullets, bold, > quotes and tables all work. Do not write HTML, and do not add a sign-off or a footer — the template supplies both.
LINKS. Never write an absolute youspot.com URL; you do not reliably know them, and a wrong one reaches the reader as a dead link. Write one of these two forms instead and they are resolved for you: Acme Corp — links to an object in the user's graph. The id must come from a graph tool result you actually ran; an id that is not theirs silently loses its link. [Which of these should I chase?](chat:Which of these prospects should I chase first?) — opens chat with that question ready to send. Link the objects you name, so the reader can go straight to what you are telling them about. End with one 'chat:' link offering the obvious next question — it is the cheapest way for them to act on what you found. The reader sends that question as their own, so never put their employer, title or role in it unless the About this user block states it; ask without naming a company rather than guess one.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| body | Yes | The body of the email, as Markdown. Use [label](object:<id>) to link a graph object and [label](chat:<question>) to link a ready-to-send chat question. | |
| subject | Yes | The email subject line. |