Skip to main content
POST
Register a custom domain

Authorizations

Authorization
string
header
required

An API key (klk_...) or a Clerk session token. Both resolve to the same account and behave identically.

Body

application/json
hostname
string
required

The hostname to serve your codes on.

Example:

"go.example.com"

Response

Registered; add the returned DNS records.

id
string
required
hostname
string
required
verified
boolean
required
cert_status
string | null
required
hostname_status
string | null
validation_errors
string[]
created_at
integer

When the domain was registered. Epoch milliseconds.

Example:

1755734400000

dns
object[]
next
string