Connect Domain

FAQ

Short answers to common questions about connecting domains.

Which DNS providers auto-configure records?

19 providers have a built-in adapter (Cloudflare, Route 53, GoDaddy, Namecheap, and more) plus Domain Connect as a redirect-based, tokenless option. See DNS providers for the full list and Provider setup for per-provider credential steps and eligibility gates.

Does it support apex domains as well as subdomains?

Yes — a connection's kind is apex or subdomain (see the Connection schema in the API reference). Apex support depends on the provider's capabilities (ALIAS/ANAME/CNAME flattening); POST /v1/domains:check returns apex_flattening and www_redirect_recommended so you can steer the customer to the right setup.

Does it support wildcard domains?

POST /v1/domains:check returns a capabilities.wildcard flag per detected provider, reflecting whether that provider's DNS supports wildcard records. Whether wildcard is offered in your product depends on how you use that capability flag in your own onboarding flow.

How long does DNS propagation usually take?

It depends on the TTL of any records being replaced and the customer's resolver/registrar — from minutes (delegated auto-write with fresh records) to longer if a previous record had a long TTL. POST /v1/connections/{id}/records:check reports live propagation state per record; see Troubleshooting.

What happens if I revoke or delete an API key?

Revocation is immediate — a revoked key stops authenticating on its very next request. Keys are never returned by list endpoints after creation; only metadata (last4, scopes, timestamps) is visible.

Can a connection lose its "live" status?

Yes — if a live domain's records stop resolving to their intended values, it transitions to drifted and fires domain.drift. See Connections.

Is there a sandbox / test mode?

Yes — API keys are prefixed sk_test_/sk_live_, and applications have a test/live environment. make dev seeds a demo application and sk_test_demo key for local development (see the Quickstart).

On this page