Verify a domain now
Reads the domain's TXT record through public DNS now. When every public resolver that answers sees it, and no other org holds the name, the domain is `verified`; otherwise it stays as it was, and `problem` says why. A verified domain is also read again every day. Six times a minute for a domain. Needs `org.sso.edit` across the org and a plan with `team.sso`. Recorded as `org_domain.verified` when it verifies.
/v1/orgs/{org}/domains/{domain}/verifyReads the domain's TXT record through public DNS now. When every public resolver that answers sees it, and no other org holds the name, the domain is verified; otherwise it stays as it was, and problem says why. A verified domain is also read again every day. Six times a minute for a domain. Needs org.sso.edit across the org and a plan with team.sso. Recorded as org_domain.verified when it verifies.
Authorization
bearer An org API key (sk_live_…, sk_test_…), or an access token from the Synq issuer (the synq brand, on the accounts host) for this API.
In: header
Path Parameters
The org's id
^org_[0-9a-hjkmnp-tv-z]{26}$The domain's id
^odm_[0-9a-hjkmnp-tv-z]{26}$Response Body
application/json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
application/problem+json
curl -X POST "https://api.synq.build/v1/orgs/org_01h455vb4pex5vsknk084sn02q/domains/odm_01h455vb4pex5vsknk084sn02q/verify" \ -H "Authorization: Bearer $SYNQ_API_KEY"{ "id": "odm_01h455vb4pex5vsknk084sn02q", "domain": "acme.com", "status": "pending", "verification": { "type": "TXT", "host": "_synq-verification.acme.com", "value": "synq-verification=k7q2m5x9a3b4c6d8e2f7g5h3j9k4m2n6" }, "problem": "record_not_found", "verified_at": "2026-10-21T12:00:00.000Z", "failing_until": "2026-10-21T12:00:00.000Z", "last_checked_at": "2026-10-21T12:00:00.000Z", "created_at": "2026-10-21T12:00:00.000Z"}List an org's verified domains GET
The domains the org proved it owns, or is proving, with the TXT record each needs. Needs `org.sso.view` across the org, on any plan.
Add a domain to verify POST
A domain the org proves it owns, so its people can sign in through its own identity provider: on a plan with `team.sso` (Enterprise). It starts `pending`, with the TXT record to publish; then verify it. Several orgs may add a name, and the first to prove it holds it. At most 10 added a day, and 20 in all. Needs `org.sso.edit` across the org. Recorded as `org_domain.created`.