API

REST API reference

All endpoints, parameters, example requests and responses. Authentication: API key (Bearer).

Quick example

curl https://api.sendnomi.com/v1/messages \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "from": "[email protected]",
    "to": "[email protected]",
    "subject": "Welcome",
    "html": "<h1>Hello!</h1>"
  }'

The API key is obtained from the panel → Developer tab. Separate keys for production and test environments.

Endpoint list

  • POST /v1/messages Send a single or bulk email.
  • GET /v1/messages/{id} Query the status of a specific message.
  • GET /v1/messages Message list, with filtering and pagination.
  • POST /v1/templates Create a new template (Handlebars + Liquid mix).
  • GET /v1/templates/{id} Template detail.
  • POST /v1/suppressions Add an address to the suppression list.
  • GET /v1/suppressions Suppression list.
  • POST /v1/webhooks Register a webhook endpoint.
  • GET /v1/events Event stream (sent, delivered, opened, clicked, bounced, complained).
  • GET /v1/domains Your verified domains.

Coming soon. A Try-It-Out panel for every endpoint (with cURL · JS · Python tabs).