Guides/How to use a custom domain with CNAME

How to use a custom domain with CNAME

Your domain, your pages. mysite.com → Sutrena.

Updated March 2026

Custom domains let you serve Sutrena pages from your own domain. Each custom domain is linked to a specific subdomain — it serves the same pages as that subdomain. Deploy pages to a subdomain first, then add the domain. Requires Builder plan or higher.

1. Deploy pages to a subdomain

First, deploy your pages to a subdomain. This is the subdomain your custom domain will serve from.

# List your subdomains to get the ID
curl https://sutrena.com/api/account/subdomains \
  -H "Authorization: Bearer $KEY"

# Deploy pages to that subdomain
curl -X POST https://sutrena.com/api/pages \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug": "index", "title": "My Site", "html": "<h1>Hello</h1>", "subdomainId": "YOUR_SUBDOMAIN_ID"}'

2. Register your domain linked to the subdomain

Add your domain via the API. Specify subdomainId to control which subdomain's pages are served. If omitted, your first/default subdomain is used.

curl -X POST https://sutrena.com/api/account/domains \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"domain": "mysite.com", "subdomainId": "YOUR_SUBDOMAIN_ID"}'

3. Add CNAME record

In your DNS provider, add a CNAME record for your domain pointing to cname.sutrena.com.

4. Check verification status

DNS propagation takes 5-15 minutes. Check status via API. The response includes subdomainId and subdomainName showing which subdomain the domain serves from.

curl https://sutrena.com/api/account/domains/DOMAIN_ID \
  -H "Authorization: Bearer $KEY"

5. Your site is live

Once DNS is verified and SSL is active, your pages are served at both mysite.com/slug and subdomain.sutrena.com/slug simultaneously.

FAQ

How many custom domains can I have?

Builder: 1, Pro: 5, Scale: unlimited.

Which subdomain does a custom domain serve from?

Each custom domain is linked to one specific subdomain. Specify subdomainId when adding the domain, or it defaults to your first subdomain. You can change this later with PATCH /api/account/domains/:id.

Can I change which subdomain a domain serves from?

Yes. Use PATCH /api/account/domains/:id with {"subdomainId": "new-id"} to re-point the domain without deleting and re-adding it.

How long does DNS verification take?

Usually 5-15 minutes. SSL provisioning may take up to 30 minutes.

What is Sutrena?

Sutrena is the web runtime for AI agents. Three primitives — pages, forms, and dashboards — accessible through one API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Framework-agnostic. Works from any MCP client or HTTP client.

Get started in two API calls

1. Get a trial key (no auth, no signup)

curl -X POST https://sutrena.com/api/trial

2. Create a form + dashboard from a template

curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"templateId": "waitlist", "createDashboard": true}'

Ready to build?

Get a trial API key instantly with no signup, or create an account for the full experience.

How to Use a Custom Domain with CNAME | Sutrena | Sutrena