API Reference
The Sendvaults REST API. All requests must be authenticated and use HTTPS.
Base URL: https://api.sendvaults.com/v1
POST
/emails
Send an email
Body Parameters
| Parameter | Type | Description |
|---|---|---|
| from required | string | Sender email address. Must be from a verified domain. |
| to required | string | string[] | Recipient email address(es). Up to 50 recipients. |
| subject required | string | Email subject line. Max 998 characters. |
| html | string | HTML body of the email. One of html or text is required. |
| text | string | Plain text body of the email. |
| reply_to | string | Reply-to email address. |
| cc | string[] | CC recipients. |
| bcc | string[] | BCC recipients. |
Example Request
POST /v1/emails
{
"from": "hello@yourdomain.com",
"to": "user@example.com",
"subject": "Your verification code",
"html": "<p>Your code is <strong>482910</strong></p>"
}
{
"from": "hello@yourdomain.com",
"to": "user@example.com",
"subject": "Your verification code",
"html": "<p>Your code is <strong>482910</strong></p>"
}
Example Response
{
"id": "em_01h9xyz123abc456",
"status": "queued",
"created_at": "2026-06-03T10:00:00Z"
}
"id": "em_01h9xyz123abc456",
"status": "queued",
"created_at": "2026-06-03T10:00:00Z"
}
GET
/emails
List sent emails
Query Parameters
| Parameter | Type | Description |
|---|---|---|
| limit | integer | Number of results (1–100, default 20). |
| offset | integer | Pagination offset. |
| status | string | Filter by status: queued, delivered, bounced, failed. |
POST
/domains
Add a sending domain
Body Parameters
| Parameter | Type | Description |
|---|---|---|
| domain required | string | The domain name to add (e.g. yourdomain.com). |
Error Codes
| Code | Meaning |
|---|---|
| 400 | Bad Request — Invalid parameters. |
| 401 | Unauthorized — Missing or invalid API key. |
| 403 | Forbidden — Insufficient permissions. |
| 404 | Not Found — Resource does not exist. |
| 429 | Rate Limited — Slow down your requests. |
| 500 | Server Error — Something went wrong on our end. |