Sby SendGrid
Create a Single Send
Creates an unscheduled draft marketing email for lists, segments or all contacts, with its content, sender and unsubscribe settings.
Description
Set `send_to` (`list_ids`, `segment_ids` or `all`) and `email_config`: the subject and HTML, or a `design_id`, the `sender_id`, and a `suppression_group_id` or `custom_unsubscribe_url`. A `send_at` here only prefills the date; schedule the Single Send to send it.
create-single-send.md
Create a Single Send
Creates an unscheduled draft marketing email for lists, segments or all contacts, with its content, sender and unsubscribe settings.
Set send_to (list_ids, segment_ids or all) and email_config: the
subject and HTML, or a design_id, the sender_id, and a
suppression_group_id or custom_unsubscribe_url. A send_at here only
prefills the date; schedule the Single Send to send it.
Set up
Use the first option your agent supports.
API (official)
- Base URL: https://api.sendgrid.com
- Endpoint:
POST /v3/marketing/singlesends - Auth: send the header
Authorization: Bearer $SENDGRID_API_KEY - Get a key: https://app.sendgrid.com/settings/api_keys
- Docs: https://www.twilio.com/docs/sendgrid/api-reference
Before doing anything else, make one read-only call to confirm access.
Rules
- Ask the user before anything that sends messages, costs money, or changes data.
- Never print API keys.
Built from these files in the repository
The layout and the rules come from lib/catalog/render-markdown.ts, the set-up wording from lib/catalog/render-access.ts.
Ways in
| Route | Source | Call | Required | Docs |
|---|---|---|---|---|
| Official | POST /v3/marketing/singlesends | API key in $SENDGRID_API_KEY | Docs |