# Verify a custom domain now

<div class="api-op" data-api-operation>
<div class="api-op__main">

<p class="api-endpoint"><span class="method method-post">POST</span> <code>/v1/custom_domains/&#123;custom_domain&#125;/verify</code></p>

Email sender domains prove current DNS configuration only; this does not attest provider acceptance or delivery. Portal, broker and SCIM hostnames read their Cloudflare for SaaS hostname and certificate status immediately instead of waiting for the periodic status check.

<dl class="api-facts"><div><dt>Scope</dt><dd><code>custom_domains:write</code></dd></div><div><dt>Auth</dt><dd>Secret key (<code>sk_…</code>)</dd></div><div><dt>Since</dt><dd>1.0</dd></div></dl>

## Path parameters

<ul class="api-fields">
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">custom_domain</code> <span class="api-field__type">string</span> <span class="api-field__required">Required</span></p>
</li>
</ul>

## Headers

<ul class="api-fields">
<li class="api-field">
<p class="api-field__head"><code class="api-field__name">OhAuthCat-Version</code> <span class="api-field__type">string</span></p>
Minor version; defaults to the environment's pin.
</li>
</ul>

## Responses

<ul class="api-responses">
<li class="api-response"><span class="api-status api-status--ok">200</span> <span>OK <span class="api-field__type">CustomDomain</span></span></li>
<li class="api-response"><span class="api-status api-status--neutral">default</span> <span>Any other error, including <a href="/errors/internal_error/">internal_error</a>. Every code is in the error catalogue. <span class="api-field__type">Error</span></span></li>
</ul>

Errors share one shape; see the [error code catalogue](/errors/).

</div>
<div class="api-op__code">

**curl**

```sh wrap
curl -X POST \
  "https://api.ohauthcat.com/v1/custom_domains/cdom_01J9Z3K5V7W8X9Y0Z1A2B3C4D5/verify" \
  -H "Authorization: Bearer $OHAUTHCAT_API_KEY"
```

**Node**

```javascript wrap
const response = await fetch(
  "https://api.ohauthcat.com/v1/custom_domains/cdom_01J9Z3K5V7W8X9Y0Z1A2B3C4D5/verify",
  {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.OHAUTHCAT_API_KEY}`,
    },
  },
);
const data = await response.json();
```

**Python**

```python wrap
import os
import requests

response = requests.post(
    "https://api.ohauthcat.com/v1/custom_domains/cdom_01J9Z3K5V7W8X9Y0Z1A2B3C4D5/verify",
    headers={"Authorization": f"Bearer {os.environ['OHAUTHCAT_API_KEY']}"},
)
data = response.json()
```

```json title="Response 200" wrap
{
  "id": "cdom_01J9Z3K5V7W8X9Y0Z1A2B3C4D5",
  "object": "custom_domain",
  "type": "portal",
  "hostname": "acme.com",
  "state": "pending",
  "dns_records": [
    {
      "type": "CNAME",
      "name": "Acme Corp",
      "value": "enterprise"
    }
  ],
  "created_at": "2026-01-15T09:30:00Z"
}
```

</div>
</div>
