Overview

What DoDomain is and how it adds custom-domain support to your SaaS in one flow.

DoDomain is a custom-domain connection service for SaaS products. Instead of building DNS instructions, verification polling, and provider quirks into your own product, you drop in DoDomain: your server mints a connect session over REST, your end user finishes DNS setup in a hosted flow (or an embedded widget), and DoDomain verifies the records against the domain's authoritative nameservers and calls your webhook with a signed event.

How it works

Your server creates a session — one POST /api/v1/sessions call describing the DNS records your product needs on the customer's domain (for example a CNAME pointing at your edge).
Your user connects the domain — the returned connectUrl opens a hosted flow that detects the user's DNS provider and picks the best path: on Cloudflare it offers a real one-click apply via OAuth; everywhere else it shows provider-specific, copy-paste instructions with live per-record verification.
DoDomain verifies and tells you — records are checked against the domain's authoritative nameservers, and a signed connection.verified webhook fires the moment everything matches.
Monitoring keeps it honest — verified connections are re-checked automatically (every 10 minutes for their first day, then hourly for a week, then every 6 hours); if DNS drifts, the suspicion is confirmed within minutes, you get a connection.failed webhook, and you can trigger a re-verify on demand.

The pieces

Getting started

The connect flow

Hosted page, embeddable widget, provider detection, and the connect tiers.

Webhooks and monitoring

The signature scheme, the four events, and the built-in DNS monitor.

REST API

Every /api/v1 endpoint, authentication, and rate limits.

SDKs

@dodomain/node or dodomain-sdk for your server, @dodomain/connect for your frontend.

AI assistants (MCP)

Connect Claude or any MCP client to DoDomain with one URL.

Where things live

dodomain.io — the marketing site and public docs.
app.dodomain.io — the dashboard, the hosted connect flow, and the API base URL.
npm — @dodomain/node (server SDK) and @dodomain/connect (browser widget), both MIT-licensed with zero runtime dependencies.
PyPI — dodomain-sdk (Python server SDK, sync and async), MIT-licensed, httpx its only dependency.