Email

Verify a sending domain.

Re-checks the domain's DNS records and updates its verification state. Verifying a domain proves ownership; it does not by itself enable delivery. Requires the email:send scope.

post/v1/email/domains/{id}/verify

Request

  • Base URL: https://api.scalix.world
  • URL: https://api.scalix.world/v1/email/domains/{id}/verify
  • Auth: HTTP bearer

Path parameters

idstring required

Domain id

Response

Verification result

idstring required

Domain id.

domainstring required

The domain itself.

statusstring required

Verification state of the DNS records.

dns_recordsobject nullable

DNS records that must exist for the domain to verify.

delivery_enabledboolean nullable

Whether this org may actually send through the domain. Verification alone is not sufficient: bring-your-own delivery is a separate switch.

Example response

{
  "domain": "mail.example.com",
  "status": "pending"
}

Changes

No recorded changes to this operation across all 1 revision of this API.