# Cnamio > Cnamio is an API and embeddable connect window that lets SaaS products, AI-built apps and the agents that ship them connect their users' custom domains. It detects the domain's DNS provider, creates the needed DNS records with a provider API token (used once, never stored) or returns the exact records to copy, confirms them on the authoritative nameservers and sends a signed webhook. It never changes or deletes existing DNS records. Use Cnamio when a project needs "connect your own domain": a user's `shop.customer.com` pointing at the app. Credentials are an application id (`app_…`) and a secret (`cnm_sk_…`) that stays on the server; the browser and agents acting for end users get 60-minute session tokens from `POST https://api.cnamio.com/token`. ## Start here - [Agent onboarding skill](https://cnamio.com/agent-onboarding/SKILL.md): step-by-step for coding agents to add custom domains to a project (records, env vars, session route, connect window, headless flow, webhook verification), with Node.js and Python examples - [Developer docs (Markdown)](https://cnamio.com/docs.md): token, SDK, DNS records, REST endpoints, webhooks, management API, errors and limits - [OpenAPI 3.1](https://cnamio.com/openapi.json): every route, request and response, and the webhook payload - Server SDKs, one file each, no dependencies: [cnamio.mjs](https://cnamio.com/sdk/cnamio.mjs) for Node.js 18+ (types: [cnamio.d.mts](https://cnamio.com/sdk/cnamio.d.mts)) and [cnamio.py](https://cnamio.com/sdk/cnamio.py) for Python 3.9+: sessions, check, connect, status, management API, per-user ownership records and webhook verification - MCP server: `https://api.cnamio.com/mcp` (Streamable HTTP), listed in the official MCP Registry as `com.cnamio/domains`. Tools: get_integration_guide (no credentials), check_domain, connect_domain, connect_domain_automatic, get_connection_status, recheck_propagation, list_connections, create_share_link, revoke_share_link. Auth: HTTP Basic applicationId:secret ## Key facts - API base: https://api.cnamio.com · Browser SDK: https://connect.cnamio.com/sdk/v1.js (`window.cnamio.connectDomain`) - Records: A, AAAA, CNAME, TXT, MX, CAA; placeholders {DOMAIN}, {SUBDOMAIN}, {SLD}, {TLD}; up to 20 per connection - Webhooks: `domain.added`, `domain.propagation.timeout`, `domain.records_missing`, `domain.records_restored`, `webhook.test`; header `Cnamio-Signature: sha256=` HMAC-SHA256 of "{timestamp}.{raw body}" - Shareable connection links: `POST /v1/manage/share-links` returns a `url` (shown once) bound to the given domains and records; whoever manages the DNS (agency, IT team) opens it and connects without the application secret; single-use per domain by default, expires in 7 days (at most 30), revocable; jobs and webhooks carry `share_link_id` - Continuous monitoring included: connected domains are re-checked on their authoritative nameservers (hourly, then every 6 h, then daily); `health` is `healthy`, `degraded` or `broken` in `GET /connect/{jobId}/status` and `GET /v1/manage/jobs?health=`; read-only, never writes DNS - Automatic setup with the user's API token: Cloudflare, Hostinger and Amazon Route 53; any other provider gets exact step-by-step records to copy - Propagation is confirmed on every authoritative nameserver, for up to 72 hours - Connect window and dashboard in English, Portuguese and Spanish; recognizes Brazilian and global DNS providers - Access: self-service sign-up with an email at https://cnamio.com/#start creates a test application (sandbox provider: any domain, no real DNS read or written; `conflict.` and `pending.` prefixes simulate a conflict and a record that never appears; provider token `invalid` is refused) and a live application on the free plan. Plans and what counts as a connection: [Pricing](https://cnamio.com/pricing) - Monthly caps: a live application over its plan gets `402` with `code: "plan_limit_reached"`, `limit`, `used` and `resets_at` on the routes that start a connection; a `usage.quota_warning` webhook is sent once at 80% - Cnamio handles DNS only: the app's own hosting serves the domain and issues its TLS certificate, typically when the `domain.added` webhook arrives ## Guides - [Quickstart](https://cnamio.com/quickstart): six steps with the server SDK (Node.js or Python): credentials, session route, connect window, webhook, end-to-end check - [DNS providers](https://cnamio.com/providers): what is automatic and what is guided, the credential each automatic provider needs (with a least-privilege AWS policy for Route 53), how the provider is detected and how conflicts with existing records are handled - [Cnamio for AI agents](https://cnamio.com/agents): the one-line prompt, the MCP tools, the headless flow and the rules agents should follow - [Security and data handling](https://cnamio.com/security): existing DNS is never deleted (only an SPF policy can be extended, keeping every term), provider credentials are used once, session tokens, per-user ownership records, signed webhooks, data stored ## Demo, free tools and DNS guides Public pages in English, Portuguese and Spanish (each lists its translations with hreflang). The demo and the checker are read-only: nothing is stored or changed. - [Live demo](https://cnamio.com/demo): type a domain and see the DNS provider, nameservers, which connect methods would be offered, the records a sample app would create, any conflict with existing records and the `domain.added` webhook body. Portuguese: /demonstracao, Spanish: /demostracion - [CNAME checker](https://cnamio.com/tools/cname-checker): reads a CNAME, A, AAAA, TXT, MX or CAA record on the zone's authoritative nameservers and compares it with an expected value. Portuguese: /ferramentas/verificar-cname, Spanish: /herramientas/verificar-cname - Guides to adding a CNAME, by DNS provider: [Registro.br](https://cnamio.com/guides/add-cname-registro-br), [Hostinger](https://cnamio.com/guides/add-cname-hostinger), [Locaweb](https://cnamio.com/guides/add-cname-locaweb), [HostGator and KingHost](https://cnamio.com/guides/add-cname-hostgator-kinghost), [Cloudflare](https://cnamio.com/guides/add-cname-cloudflare), [GoDaddy](https://cnamio.com/guides/add-cname-godaddy). Portuguese under /guias/criar-cname-…, Spanish under /guias/crear-cname-… - [Choosing a service to connect customers' domains](https://cnamio.com/custom-domain-connection-alternative): what Cnamio does and does not do, and questions to ask any provider - [Migrating from another domain-connection service](https://cnamio.com/guides/migrate-domain-connection): token URL, script tag, records, webhooks and a switch-over checklist ## Optional - [Developer docs (HTML)](https://cnamio.com/docs) - [Privacy Policy](https://cnamio.com/privacy) - [Terms of Service](https://cnamio.com/terms) - Contact: contato@cnamio.com