send_to_list
Send an email to a contact list by creating a single send with subject, HTML, plain text, and sender details. Optionally specify list IDs, segment IDs, and unsubscribe options.
Instructions
Send an email to a contact list using SendGrid Single Sends
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"name": "<name>",
"subject": "<subject>",
"html_content": "<html_content>",
"plain_content": "<plain_content>",
"sender_id": "<sender_id>"
},
"name": "send_to_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the single send | |
| subject | Yes | Email subject line | |
| list_ids | No | Array of list IDs to send to | |
| sender_id | Yes | ID of the verified sender | |
| segment_ids | No | Optional array of segment IDs to send to | |
| html_content | Yes | HTML content of the email | |
| plain_content | Yes | Plain text content of the email | |
| suppression_group_id | No | ID of the suppression group for unsubscribes (required if custom_unsubscribe_url not provided) | |
| custom_unsubscribe_url | No | Custom URL for unsubscribes (required if suppression_group_id not provided) |