Overview
API overview
Base URL, authentication, scopes and conventions of the SNDR API.
The SNDR API is plain HTTPS and JSON. Every request goes to the same base URL:
Text
https://api.sndr.sh/v1Authentication
Send your API key as a Bearer token. Keys look like sndr_live_... and are created in API keys in the dashboard.
Terminal
curl https://api.sndr.sh/v1/emails \
-H "Authorization: Bearer $SNDR_API_KEY"Keep keys on your server. Never put them in browser or mobile code.
Scopes
| Scope | Allows |
|---|---|
read | All GET endpoints. |
send | Sending and every create, update or delete. |
API keys can list keys but not create or delete them. That is done in the dashboard only.
Pagination
Paginated lists take limit (default 50, max 200) and cursor. Pass the next_cursor from one page to get the next, while has_more is true.
JSON
{
"data": [ ... ],
"next_cursor": "eyJ0cyI6...",
"has_more": true,
"count": 50,
"limit": 50
}Errors
Failed requests return an HTTP error status and an error object. See Errors for every code.