Documentation

Create a site

POST/v1/sites

Auth: Secret API key (rk_sk_)

Provision a new site with public key and identity secret.

Body parameters

NameTypeDescription
namerequiredstringSite display name
domainrequiredstringPrimary domain
widgetConfigobjectInitial widget configuration

Responses

201Created site
{
  "id": "660e8400-e29b-41d4-a716-446655440001",
  "name": "My Store",
  "domain": "store.example.com",
  "publicKey": "rk_pk_live_abc123",
  "createdAt": "2026-01-01T00:00:00Z"
}