Guides/How to set up a custom subdomain

How to set up a custom subdomain

Your pages at alice.sutrena.com. One API call.

Updated March 2026

Custom subdomains give your Sutrena pages clean, branded URLs. Instead of sutrena.com/p/my-page, your users see alice.sutrena.com/my-page. Available on all plans.

1. Choose your subdomain

Pick a name 3-30 chars, lowercase alphanumeric + hyphens.

curl -X PUT https://sutrena.com/api/account/subdomain \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"subdomain": "alice"}'

2. Create and publish pages

Your pages are now accessible at alice.sutrena.com/slug.

curl -X POST https://sutrena.com/api/pages \
  -H "Authorization: Bearer $KEY" \
  -H "Content-Type: application/json" \
  -d '{"slug": "about", "title": "About Us", "html": "<h1>About Alice</h1>"}'

3. Visit your page

Open alice.sutrena.com/about in your browser. Your page is live.

FAQ

Can I change my subdomain?

Yes, PUT /api/account/subdomain again with a new name.

Are subdomains free?

Yes, available on all plans.

Related

Documentation →Multi-page subdomain sites →Custom domains with CNAME →Deploy a page via API →Upload static assets →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 Set Up a Custom Subdomain | Sutrena | Sutrena