Skip to main content
POST
Verify Domain
Verify a domain’s DNS settings. This endpoint checks that the required DNS records (DKIM and SPF) are correctly configured and updates the domain’s status (isActive, isApproved, lastVerificationErrors, lastVerificationCheckedAt) based on the result.

Features

  • DNS records verification (DKIM and SPF)
  • Updates domain status as a side effect
  • Detailed per-record error messages on failure

Response

Returns { isVerified }. When verification fails, the response also includes a verificationErrors array, where each entry has:
  • 200 OK: Verification check completed. Inspect isVerified and verificationErrors — a 200 is returned even when verification fails.
  • 400 Bad Request: Invalid domain ID or domain not found
  • 401 Unauthorized: Invalid API key
The domain must be in ‘Active’ status to be verified. If it isn’t active yet, wait and try again.
No request body is required. The domain ID goes in the URL path.

Authorizations

Authorization
string
header
required

Path Parameters

id
string
required

Domain ID

Response

Verification check completed. Inspect isVerified and verificationErrors — a 200 is returned even when verification fails.

isVerified
boolean

Whether the domain passed verification

verificationErrors
object[]

Present when verification fails. Lists each misconfigured DNS record.