---
ref: tool:sendgrid/send-email
name: Send an email
company: company:sendgrid
workflows: []
access: [cli, api]
tags: [capability:send-email, category:email, has:api, has:cli]
docs: https://www.twilio.com/docs/sendgrid/api-reference/mail-send/mail-send
updated: 2026-09-27
---

# Send an email

Sends an email from a verified sender, with up to 1,000 personalizations that each set their own recipients.

## Set up

Use the first option your agent supports.

### CLI (official)

Install the command, then confirm it runs.

```sh
brew tap twilio/brew && brew install twilio
twilio --version
```

Run `twilio email:send`.

Set `$SENDGRID_API_KEY` in your environment first (get a key: https://app.sendgrid.com/settings/api_keys).

### API (official)

- Base URL: https://api.sendgrid.com
- Endpoint: `POST /v3/mail/send`
- 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 anything else, confirm access with the cheapest read-only call, like a list or a search. Never send or change anything to test access.

## Rules

- Ask the user before anything that sends messages, costs money, or changes data, and say how many records it touches. One approval covers a batch the user has seen.
- Never print API keys.