Skip to content
Sendtier Docs
API reference

Send up to 100 emails

Source: OpenAPI (openapi/openapi.yaml).

curl -X POST "https://api.sendtier.example/emails/batch" \  -H "Authorization: Bearer st_live_REPLACE_ME" \  -H "API-Version: 2026-10-01" \  -H "Content-Type: application/json" \  -d '{    "emails": [      {        "from": "Example <hello@mail.example.com>",        "to": [          "user@example.com"        ],        "subject": "Your first email",        "text": "Hello from Sendtier."      }    ]  }'
{  "data": [    {      "id": "string",      "status": "queued",      "status_detail": "string",      "created_at": "2019-08-24T14:15:22Z"    }  ]}
POST
/emails/batch

All emails are validated first. If one is invalid, none is queued. The domain rule matches POST /emails.

Authorization

headerAuthorizationBearer <token>

API key: st_live_... or st_test_...

Header Parameters

Idempotency-Key?string

Repeated POST with the same key within 24 h returns the first response.

Lengthlength <= 255
API-Version?string

Request Body

application/json
  1. body
emails*array<>
Items1 <= items <= 100

Response Body

All emails accepted and queued.

application/json
  1. response
data*array<>