Updated March 2026
Custom domains let you serve Sutrena pages at your own domain, like mysite.com/about instead of alice.sutrena.com/about. This is available on Builder ($9/month) and above.
Each custom domain is linked to one specific subdomain. It serves the same pages as that subdomain. Both URLs work simultaneously.
Workflow: First, deploy your pages to a subdomain. Second, register the domain with POST /api/account/domains, specifying the subdomainId to link it to. If you omit subdomainId, it defaults to your first subdomain. Third, add a CNAME record pointing your domain to cname.sutrena.com. Fourth, wait for DNS propagation and SSL provisioning (usually 5-15 minutes).
Once verified, your pages are served at both your custom domain and your subdomain. If you have a page with slug "about", it is available at both mysite.com/about and alice.sutrena.com/about. The slug "index" becomes the root at both URLs.
If you have multiple subdomains and want to change which one a domain serves from, use PATCH /api/account/domains/:id with the new subdomainId. No need to delete and re-add the domain.
Check domain status with GET /api/account/domains. Each domain shows its DNS/SSL state and which subdomain it serves from (subdomainId, subdomainName).
Plan limits: Builder gets 1 custom domain, Pro gets 5, Scale gets unlimited. You can also combine custom domains with subdomains -- use the subdomain for staging and the domain for production.
To remove a domain, call DELETE /api/account/domains/:id. The Cloudflare hostname is cleaned up automatically.
Important: the CNAME must point to cname.sutrena.com, not to an IP address. Cloudflare handles SSL termination and routing. If you are using Cloudflare for your own DNS, make sure the CNAME proxy is disabled (DNS only, grey cloud) to avoid conflicts with Cloudflare-to-Cloudflare routing.
# Step 1: Deploy pages to a subdomain first
curl -X POST https://sutrena.com/api/pages \
-H "Authorization: Bearer st_live_your_key" \
-H "Content-Type: application/json" \
-d '{
"slug": "index",
"title": "My Site",
"html": "<h1>Welcome to mysite.com</h1>"
}'
# Step 2: Register your domain (linked to your subdomain)
curl -X POST https://sutrena.com/api/account/domains \
-H "Authorization: Bearer st_live_your_key" \
-H "Content-Type: application/json" \
-d '{ "domain": "mysite.com" }'
# subdomainId is optional -- defaults to your first subdomain
# Step 3: Add CNAME in your DNS provider:
# mysite.com CNAME cname.sutrena.com
# Step 4: Check verification status
curl https://sutrena.com/api/account/domains \
-H "Authorization: Bearer st_live_your_key"
# Response includes subdomainId showing which subdomain is served
# Optional: Change which subdomain a domain serves from
curl -X PATCH https://sutrena.com/api/account/domains/DOMAIN_ID \
-H "Authorization: Bearer st_live_your_key" \
-H "Content-Type: application/json" \
-d '{ "subdomainId": "NEW_SUBDOMAIN_ID" }'