Authentication and enablement
The agent must have an inbox (agent_inboxes). No user Gmail OAuth — this is platform inbound mail, not gmail_send_email.
Inputs
to(required): recipient addresses.subject(required): for replies,Re:+ original subject.body(required).body_type—html(default) ortext.cc,from_name,file_urls(attachments as${VAR_N}) — optional.reply_to_message_id/references— from the original email’s metadata to stay in-thread.
Output
Send confirmation (message id / thread headers as returned by the mail path).Limits and side effects
- Sends a real email from the agent’s inbox.
- From address is fixed;
from_nameis display-only.
Expected errors
- Agent has no inbox.
- Empty
to,subject, orbody. - Attachment URL unreadable.