Get domain info - Manage Domains - API Reference

POST

/v3/admin/domains/{domain_id}/info

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

Returns the DNS record information and verification status for the specified verification type. Use this endpoint to retrieve the DNS records you need to add at your DNS provider before calling the Verify domain endpoint.

NYLAS API KEYACCESS TOKEN

Parameters

Path parameters

domain_id*string

ID of the domain to get DNS info for.

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 get info for.

ownershipmxspfdkimfeedback

Example: "ownership"

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>/info" \ -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": "ownership" }'

Get domain infoBeta