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/v1

Authentication

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

ScopeAllows
readAll GET endpoints.
sendSending 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.

Endpoints