Guides/How to use a custom domain with CNAME

How to use a custom domain with CNAME

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

Updated March 2026

Custom domains let you serve Sutrena pages from your own domain. Each custom domain is linked to a specific subdomain u2014 it serves the same pages as that subdomain. Deploy pages to a subdomain first, then add the domain. Requires Pro 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?

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.

Related

Documentation →Pricing →Deploy a page via API →Set up a custom subdomain →Multi-page subdomain sites →Prod, staging & preview environments →

What is Sutrena?

Sutrena is the web runtime for AI agents. Forms, Pages, Analytics, Webhooks, Automations — all through 67 MCP tools and one REST API. Your agent creates web artifacts, humans interact with them, and your agent gets the data back. Use any one feature or all of them together.

Pages

Deploy HTML instantly

Forms

Collect structured data

Automations

DSL-based pipelines with 14 step types

Analytics

Privacy-first, no cookies

Webhooks

Slack, Discord, Telegram

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 anything — a page, form, automation, or analytics site

# Create a form
curl -X POST https://sutrena.com/api/forms \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"name": "waitlist", "fields": [{"name": "email", "label": "Email", "type": "email", "required": true}]}'

# Or deploy a page
curl -X POST https://sutrena.com/api/pages \
  -H "Authorization: Bearer st_trial_xxx" \
  -H "Content-Type: application/json" \
  -d '{"slug": "index", "title": "My Site", "html": "<h1>Live</h1>"}'
/llms.txt/api/schema/llms-full.txt/.well-known/mcp.json

Ready to build?

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

Start buildingAgent docs
How to Use a Custom Domain with CNAME | Sutrena | Sutrena