---
title: "Verify the custom domain"
method: POST
path: "/support/settings/check-dns"
---

# Verify the custom domain

`POST /support/settings/check-dns`

## Request

- Base URL: `https://api.web2wave.com/api`
- URL: `https://api.web2wave.com/api/support/settings/check-dns`
- Auth: API key in header `api_key`

For a custom Support Desk email on your own domain: adds the domain to the mail provider if needed and reads back the
DKIM and MX records with their status. Add the records at your DNS provider, wait a few minutes, call again until `verified` is true.
Mail to the address is accepted only after verification. Owner and Administrators only.

## Headers

- `api_key` string, required
- `X-Web2wave-Project-Id` string

## Request body

- object
  - `custom_email` string, email: Defaults to the saved custom email

## Response `200`

Domain state

- object
  - `success` boolean
  - `verified` boolean
  - `message` string
  - `domain` string
  - `dns_records` object[]

## Other responses

- `422`: standard error (`error_msg`) — no valid custom email, it is on the platform domain, or the address or its domain is used by another project or account

## Changes

- **2026-11-03** `eb8b2d9124ac`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/web2wave/apis/web2wave-api/changes/support/settings/check-dns/post.md)

---

[API](https://skmtc.dev/web2wave/apis/web2wave-api.md) - [All operations](https://skmtc.dev/web2wave/apis/web2wave-api/llms.txt) - [OpenAPI document](https://skmtc.dev/web2wave/apis/web2wave-api/revisions/eb8b2d9124ac?raw)