Use the /v1/emails/send endpoint to send a single email.
POST /v1/emails/send
Content-Type: application/json
Authorization: Bearer sb_live_your_api_key
{
"from": "you@yourdomain.com",
"from_name": "Your Company",
"to": "recipient@example.com",
"subject": "Welcome to our service!",
"html": "<h1>Welcome!</h1><p>Thanks for signing up.</p>",
"text": "Welcome! Thanks for signing up.",
"reply_to": "support@yourdomain.com",
"tags": ["welcome", "onboarding"]
}{
"success": true,
"message_id": "msg_abc123xyz",
"status": "queued"
}| Parameter | Type | Required | Description |
|---|---|---|---|
| to | string | Yes | Recipient email |
| subject | string | Yes | Email subject |
| from | string | No | Sender email (must be verified domain) |
| from_name | string | No | Sender display name |
| html | string | No* | HTML content |
| text | string | No* | Plain text content |
| reply_to | string | No | Reply-to address |
| tags | array | No | Tags for tracking |
* At least one of html or text is required
Send up to 1,000 emails in a single API call using /v1/emails/batch.
POST /v1/emails/batch
{
"emails": [
{"to": "user1@example.com", "subject": "Hello User 1", "html": "..."},
{"to": "user2@example.com", "subject": "Hello User 2", "html": "..."}
]
}