API Reference

All endpoints return JSON. Authenticate with a Bearer token in the Authorization header.

Base URL: https://send.grosend.com
Auth: Authorization: Bearer sv_live_...

Endpoints

POST/api/v1/emailsSend an email

GET/api/v1/emailsList sent emails

GET/api/v1/emails/:idGet email details

POST/api/v1/domainsVerify a domain

GET/api/v1/domainsList domains

POST/api/v1/templatesCreate template

GET/api/v1/templatesList templates

POST/api/v1/webhooksCreate webhook

GET/api/v1/api-keysList API keys

POST/api/v1/api-keysCreate API key

GET/api/v1/analytics/overviewGet analytics overview

GET/api/v1/analytics/timeseriesGet time-series data

GET/api/v1/accountGet account info

PUT/api/v1/account/passwordChange password

Response format

JSON Response

{
  "id": "uuid",
  "status": "queued",
  "from": "hello@yourdomain.com",
  "to": ["recipient@example.com"],
  "subject": "Welcome",
  "createdAt": "2025-01-15T10:30:00Z"
}

Error handling

Error Response

{
  "error": "Domain not verified"
}

Errors return HTTP status codes: 400 validation, 401 auth, 403 forbidden, 404 not found, 429 rate limit, 500 server error.