Create domains

Requires a user JWT with the admin role. Administrative setup may exceed customer limits with an audit reason. Sending checks remain unchanged.

Authorization

AdminJWT

AuthorizationBearer <token>

User JWT; backend checks the admin role. Project API keys cannot access admin endpoints.

In: header

Path Parameters

project_id*integer

Range0 <= value

Request Body

application/json

TypeScript Definitions

Use the request body type in TypeScript.

name*string

mta_provider*string

Value in"aws" | "hisend"

routing_addresses?

preserve_routing_local_parts?boolean

reason?string

Audit reason; required for limit exceptions, lock/score changes, overrides, rotation and deletion.

Response Body

`application/json`

curl -X POST "https://api.hisend.app/v1/admin/projects/0/domains" \  -H "Content-Type: application/json" \  -d '{    "name": "string",    "mta_provider": "aws"  }'

{}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

{
  "error": "string",
  "message": "string"
}

Create domains

Authorization

Path Parameters

Request Body

Response Body

200application/json

400application/json

401application/json

403application/json

404application/json

409application/json

500application/json

502application/json

503application/json

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`

`application/json`