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.

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 Set Up a Custom Subdomain | Sutrena | Sutrena