Sites / Create site

Create site

POST/v1/sites

Create a new site. The response includes the server-generated id and site_key. Note that the dashboard UI currently assumes one site per account, so additional sites are API-only for now.

Body parameters

name

string

Label for the site.

domain

string

Canonical origin like https://example.com. No path or trailing slash.

timezone

string

IANA timezone. Defaults to America/New_York.

Response fields

string

Prefixed identifier, e.g. site_29Et…. Use this in URLs.

name

string

Human-friendly label. Defaults to My Website.

domain

string | null

Canonical origin, e.g. https://northwind.com. null until set.

timezone

string

IANA timezone. Defaults to America/New_York.

site_key

string

Short public key used in the install snippet. Not the same as id.

created_at

timestamp

When the site was created.

id and site_key both start with site_ but are different. id is the REST resource id used in URLs; site_key is the short public key embedded in the install snippet.

POST/v1/sites

curl https://app.converly.io/api/v1/sites \
  -H "Authorization: Bearer sk_live_…" \
  -d '{
    "name": "Northwind",
    "domain": "https://northwind.com"
  }'

201 Created

{
  "id": "site_29Et…",
  "name": "Northwind",
  "domain": "https://northwind.com",
  "timezone": "America/New_York",
  "site_key": "site_1VQH84sr",
  "created_at": "2026-06-30T12:00:00.000Z"
}