Skip to content

Add a custom domain (self-service)

POST
/v1/domains

Register a domain and receive the DNS records to publish. Created pending-dns; call verify once the records are live.

Authorizations

apiKey

Scoped API key. Scopes are readwriteadmin. A call needing more scope than the key holds returns 403 insufficient_scope.

Type
HTTP (bearer)

Request Body

application/json
JSON
{
  
"domain": "acme.in",
  
"kind": "webhook"
}

Responses

Created — publish the returned DNS records.

application/json
JSON
{
  
"id": "dom_01JX9",
  
"domain": "string",
  
"state": "string",
  
"records": [
  
  
{
  
  
}
  
]
}

Playground

Authorization
Body

Samples

Powered by VitePress OpenAPI

Apache-2.0 licensed · a Finnoto product