Skip to content
Sendtier Docs
API reference

Add a sending domain

Source: OpenAPI (openapi/openapi.yaml).

curl -X POST "https://api.sendtier.example/domains" \  -H "Authorization: Bearer st_live_REPLACE_ME" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "id": "string",  "name": "string",  "status": "pending",  "records": [    {      "purpose": "dkim",      "type": "CNAME",      "name": "string",      "value": "string",      "priority": 0,      "status": "pending"    }  ],  "last_checked_at": "2019-08-24T14:15:22Z",  "created_at": "2019-08-24T14:15:22Z"}
POST
/domains

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

Request Body

application/json
  1. body
name*string

Response Body

Domain created. Add the DNS records, then call verify.

application/json
  1. response
id*string
name*string
status*string
Value in"pending""verified""failed"
records*array<>
last_checked_at?string
Formatdate-time
created_at*string
Formatdate-time