---
title: "Verify domain"
method: POST
path: "/v3/admin/domains/{domain_id}/verify"
tags: ["Manage Domains"]
---

# Verify domain

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

<div id="admonition-warning">⚠️ <b>Before you can use the Manage Domains endpoints, you need a <a href="/docs/v3/auth/nylas-service-account/">Nylas Service Account</a></b>.</div>

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](/docs/reference/api/manage-domains/get-domain-info/) endpoint.

## Request body

- object
  - `type` 'ownership' | 'mx' | 'spf' | 'dkim' | 'feedback', required — The type of DNS verification to trigger.

## Response `200`

OK

- object
  - `request_id` string — ID of the request.
  - `data` DomainVerificationResponse
    - `domain_id` string — The ID of the domain.
    - `attempt` object — Details about the verification attempt.
      - `type` 'ownership' | 'mx' | 'spf' | 'dkim' | 'feedback' — The type of DNS verification.
      - `options` object — The DNS record values to configure at your DNS provider.
        - `host` string — The DNS host value.
        - `type` string — The DNS record type.
        - `value` string — The DNS record value to set.
    - `status` 'done' | 'failed' | 'pending' — The status of the verification attempt.
    - `created_at` number — When the verification attempt was created, in seconds using the Unix timestamp format.
    - `expires_at` number — When the verification attempt expires, in seconds using the Unix timestamp format.
    - `message` string — A human-readable message about the verification status.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `404` — Not Found
- `429` — Rate Limit

---

[API](https://skmtc.dev/nylas/apis/nylas-api.md) · [All operations](https://skmtc.dev/nylas/apis/nylas-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/nylas/nylas-api/revisions/51c2c1b4ecff/schema)