Skip to main content

​
1. Declare the domain in your manifest

Add a [[domains]] block to telnyx.toml:
Ship your function:
The CLI validates the hostname at ship time: lowercase, valid domain format, unique within the manifest.

​
2. Register the domain

Replace <function_id> with the ID from telnyx-edge list. The command returns a DNS TXT record:

​
3. Add the DNS routing record

In addition to the TXT verification record, add an A record pointing your domain to the Edge Compute load balancer:
If your DNS provider doesn’t support A records on the root domain, use a CNAME instead:
DNS propagation usually takes a few minutes.

​
4. Verify ownership

Telnyx looks up the TXT record and compares it against the stored token. On success:
  • HTTP routing is deployed — your domain is reachable over HTTP immediately
  • The domain is marked as verified
If the TXT record isn’t found yet, the domain is marked as verification_failed. Retry after the DNS record propagates.

​
5. Upload your TLS certificate

The certificate must:
  • Be PEM-encoded
  • Cover the domain (SAN or CN match)
  • Be currently valid (not expired, not yet valid)
On success, HTTPS routing is deployed. Your function is now live at https://api.acme.com.

​
6. Verify it works

The default *.telnyxcompute.com URL still works:

​
Manage your domains

List all custom domains:
Delete a domain (tears down routing, removes cert):
Deleting a domain removes the routing resources from all clusters and deletes the stored certificate. The default *.telnyxcompute.com URL is unaffected.