Authentication
Send a scoped srs_live_ key as a Bearer token. Revoked or expired keys are rejected.
REST API
REST API
Send with one JSON request. Idempotency keys prevent duplicate deliveries.
Core resources
POST /v1/emails — queue a message GET /v1/emails/{id} — inspect message state
Response model
202 means queued, not inboxed. 403 can indicate missing scope or an unverified domain. 422 blocks a suppressed recipient. 429 indicates rate limiting.
Current access model
Current dashboard keys use srs_live_. Before a customer From-domain is verified, use the shared sandbox sender only for project-member recipients. After DNS verification, external sending is governed by plan quotas, suppression, recipient throttles, and abuse controls. A 202 response means queued, not delivered.
POST /v1/emails
Authorization: Bearer srs_live_...
Idempotency-Key: reset-4821
Content-Type: application/json
{
"from": "Sender Name <info@example.com>",
"to": ["user@example.net"],
"subject": "Reset your password",
"html": "<p>Click to reset your password.</p>"
}