Verify domain - Manage Domains - API Reference

POST

/v3/admin/domains/{domain_id}/verify

⚠️ Before you can use the Manage Domains endpoints, you need a Nylas Service Account.

Triggers a verification check for the specified DNS record type. Before calling this endpoint, add the required DNS records to your domain's DNS configuration. You can get the required records by calling the Get domain info endpoint.

NYLAS API KEYACCESS TOKEN

Parameters

Path parameters

domain_id*string

ID of the domain to verify.

Header parameters

X-Nylas-Signature*string

A Base64-encoded signature using your private key's RSA with a 2048-bit key and an SHA-256 hashed string of the path, method, timestamp, nonce, and payload.

X-Nylas-Kid*string

The private_key_id from your Service Account JSON file.

X-Nylas-Nonce*string

A randomly generated nonce. Each request needs to have a unique nonce. If you try to reuse a nonce, Nylas rejects the request.

X-Nylas-Timestamp*number

The time when you submit your request, in seconds using the Unix timestamp format. This timestamp should fall within a 5-minute window of your real request time.

Request body

type*string

The type of DNS verification to trigger.

ownershipmxspfdkimfeedback

Example: "dkim"

Responses

request_idstring

ID of the request.

Example: "5fa64c92-e840-4357-86b9-2aa364d35b88"

dataobject

curl -X POST "https://api.us.nylas.com/v3/admin/domains/<DOMAIN_ID>/verify" \ -H "Content-Type: application/json" \ -H "X-Nylas-Signature: <BASE64_SIGNATURE>" \ -H "X-Nylas-Kid: <SERVICE_ACCOUNT_ID>" \ -H "X-Nylas-Nonce: <NONCE>" \ -H "X-Nylas-Timestamp: 1742932766" \ -d '{ "type": "dkim" }'

Verify domainBeta