Skip to main content

Base URL

Request format

  • All request bodies are JSON (Content-Type: application/json)
  • All responses are JSON
  • Dates are ISO 8601 (2026-02-24T10:00:00.000Z)
  • IDs are UUIDs

Error format

All errors return a consistent structure:

Common error codes

Idempotency

The POST /v1/inboxes/:id/send endpoint requires an Idempotency-Key header. If you retry a request with the same key, we return the original response without sending a duplicate email. Keys are scoped to your account and expire after 24 hours.