Enqueue Email
enqueue_emailDestructive
Enqueue an email to be sent.
Consentless template emails are sent immediately. Emails to recipients who have already granted consent are sent right away. For every other recipient the email is queued, and a consent request is sent now if the recipient has none yet. A queued email is sent once its recipient has granted consent and consent state is next refreshed: by 'send_pending_emails', or by a later call to another tool that sends email. Nothing is sent while the server is idle.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"To": {
"Addresses": [
{
"Name": "Ada",
"Address": "ada@example.com"
}
]
},
"Body": {
"Text": "Hello Ada,"
},
"From": {
"Name": "Acme",
"Address": "noreply@acme.com"
},
"Subject": "Welcome"
},
"name": "enqueue_email"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| To | Yes | Recipients. | |
| Body | Yes | Email body. | |
| From | No | Sender address: an existing sender identity on a verified domain. When omitted or invalid, nothing is sent and the result names how to fix it, with up to three valid sender identities. | |
| Subject | Yes | Subject of the email. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| Result | Yes | How many emails were queued, and of those how many were released for sending now, wait for recipient consent, or are not sent because the recipient denied consent. |