Verify a custom domain now
POST /v1/custom_domains/{custom_domain}/verify: Verify a custom domain now.
POST /
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
Path parameters
Section titled “Path parameters”custom_domainstring Required
Headers
Section titled “Headers”
Minor version; defaults to the environment’s pin.OhAuthCat-Versionstring
Responses
Section titled “Responses”- 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"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();import osimport 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(){ "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"}