Mail goes out from a mailbox the workspace has already connected. Each recipient gets their own personalised copy, so a list send is many single emails, not one group message.
Order of operations
list_mailboxes: check a mailbox is connected. If the list is empty, stop. Connecting a mailbox needs a sign-in in the app.email_templateswith actionlist, then actiongetto read the one you will send.- No suitable template, or one needs fixing? Follow the
email-templatesreference. manage_email_campaignswith actionsend, the template and the recipient record ids. One recipient is fine.get_email_campaignto follow progress, andmanage_email_campaignswith actioncancelto stop what has not gone out yet.
What to know
- A template belongs to one object (for example contacts) and can only be sent to records of that object.
- A placeholder the recipient's record has no value for renders as empty text.
- Sending is paced under the mailbox's hourly and daily limits, so a large list can take a long time. The call returns before anything is delivered.
- Sent mail cannot be recalled.
Rules
- Never invent addresses: each email goes to the address on the recipient's record. Resolve recipients with the records skill.
- Show the user the template and the recipient count and wait for a clear yes before sending.
More detail
Read these when the task needs them:
- email-templates: Writing, changing and deleting templates, and which {{placeholders}} you may use.


