Create website

POST https://datafa.st/api/v1/admin/websites

Create a new website on your account. Returns the website ID and script trackingId for installation.

Requires a dft_ account token with websites:write. Website API keys cannot create websites.

Request

Body parameters

domain

string

required

Tracked domain without https://. Example: "example.com". Must pass DataFast domain validation.

timezone

string

required

Timezone used to interpret dates and group analytics buckets. Defaults to the website timezone. IANA timezone for dashboard periods and API date grouping. Examples: "America/New_York", "Europe/Paris", "UTC".

name

string

Name shown in the dashboard. Example: "My SaaS". Optional on create.

Example request body

{
  "domain": "example.com",
  "timezone": "America/New_York",
  "name": "Example SaaS"
}

Response

Returns a JSON object with status: "success" and endpoint-specific fields in data.

Response fields

data[].websiteId

string

Website ObjectId used by account tokens to choose which website to query or manage.

data[].domain

string

Created website domain.

data[].trackingId

string

Script tracking ID for the website.

Authentication

Requires a dft_ account token with websites:write. Website API keys (df_) cannot call this endpoint because it manages account-level resources.

Create tokens in Account settings → API.

Errors

400 — Invalid domain or timezone.

403 — Billing/plan limit reached.

409 — Domain already exists on your account.

See API errors for the standard error envelope, auth failures, validation errors, permission errors, and rate limits.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown

curl -X POST "https://datafa.st/api/v1/admin/websites" \ -H "Authorization: Bearer dft_xxx" \ -H "Content-Type: application/json" \ -d '{"domain":"example.com","timezone":"America/New_York","name":"Example"}'