Add a sending domain

Initiates domain verification. Returns DNS records that must be added at your domain registrar before calling POST /verify.

POST /v1/my/domains

Add a sending domain

cURL

curl --request POST \
  --url https://api.nitrosend.com/v1/my/domains \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": {
    "name": "<string>"
  }
}
'

201

{
  "id": 123,
  "name": "<string>",
  "provider": "mailgun",
  "dns_records": [
    {
      "record_type": "<string>",
      "name": "<string>",
      "value": "<string>",
      "priority": "<string>",
      "valid": "<string>"
    }
  ],
  "verified_at": "2023-11-07T05:31:56Z",
  "created_at": "2023-11-07T05:31:56Z"
}

Authorizations

Authorization · string · header · required

API key (nskey_live_...) or JWT token. API key is checked first; if not found, falls back to Devise JWT authentication.

Body

application/json

domain · object · required

Show child attributes

Response

201

application/json

Domain registered with DNS records to configure

id · integer

name · string

provider · string · default: mailgun

status · enum<string>

Available options: pending, verified, failed

dns_records · object[] | null

Show child attributes

verified_at · string<date-time> | null

created_at · string<date-time>