Skip to main content
POST
Register a new email sending domain for the tenant
This endpoint requires authentication. Include your Bearer token in the Authorization header.

Description

POST /tenant/email-domain Description: Registers the domain with the email sending provider and returns the DNS records (DKIM, SPF, and an MX record for the return-path) that must be added before the domain can be verified. A tenant may only have one email domain configured at a time; a domain can only be registered to one tenant. Authorization:
  • Required role: owner only
Method: POST

Code Examples

Authorizations

Authorization
string
header
required

JWT Authorization header using the Bearer scheme. Format: "Bearer {token}"

Body

application/json
domain
string
required
Example:

"mail.yourlabel.com"

Response

Email domain created

status
string
Example:

"success"

message
string
Example:

"Email domain created. Please add the DNS records to verify."

data
object