Skip to content
Dashboard
Theme
Theme

Verify a custom domain now

POST /v1/custom_domains/{custom_domain}/verify: Verify a custom domain now.

View Markdown

POST /v1/custom_domains/{custom_domain}/verify

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.

Scope
custom_domains:write
Auth
Secret key (sk_…)
Since
1.0
  • custom_domain string Required

  • OhAuthCat-Version string

    Minor version; defaults to the environment’s pin.

  • 200 OK CustomDomain
  • default Any other error, including internal_error. Every code is in the error catalogue. Error

Errors share one shape; see the error code catalogue.

curl -X POST \
"https://api.ohauthcat.com/v1/custom_domains/cdom_01J9Z3K5V7W8X9Y0Z1A2B3C4D5/verify" \
-H "Authorization: Bearer $OHAUTHCAT_API_KEY"
Response 200
{
"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"
}