"Best analytics tool I've used in 14 years"

Create website

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

Create a website.

Request

Authentication

  • dft_ account token with websites:write.

Body parameters

FieldTypeRequiredDescription
domainstringYesWebsite domain, for example example.com. Must pass domain validation.
timezonestringYesTimezone used to interpret dates and group analytics buckets. Defaults to the website timezone.
namestringNoHuman-readable name for the resource or event. The exact meaning depends on the endpoint.

Response

Returns a JSON object with status and endpoint-specific fields.

Response fields

FieldTypeDescription
data[].websiteIdstringWebsite ObjectId used by account tokens to choose which website to query or manage.
data[].domainstringCreated website domain.
data[].trackingIdstringScript tracking ID for the website.

Errors

Common errors include 400 for invalid input, 401 for missing or invalid tokens, 403 for missing permissions or website access, 404 for missing resources, and 500 for server errors.

✍️ Something missing? Suggest features.

🤖 AI agent or LLM? Read this page as markdown

Example request
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"}'
Success response
{
  "status": "success",
  "data": [{
    "websiteId": "665f0b3c4d2e1a0012345678",
    "domain": "example.com",
    "trackingId": "dfid_abc123"
  }]
}