Tool
tracking_domains_create
Claim a first-party tracking host under a product domain
Claim a first-party tracking host under a product domain
Behavior
- HTTP
POST /tracking/domains
Arguments
Name | Type | Required | Description |
|---|---|---|---|
host | string | — | Bare hostname to serve tracking from, which must sit under the chosen domain (e.g. analytics.example.com); a suggestion is used when omitted |
records | array | — | DNS records to request instead of the default CNAME to the tracking edge; leave unset unless the domain needs custom records |
domainId | string | • | Product domain to claim the tracking host under, as listed in `domains[].domainId` by tracking_domains_list |
Response
Field | Type | Always | Description |
|---|---|---|---|
binding | object | • | The binding as just claimed; it starts `pending` and goes `active` once the DNS is observed live |
instructions | array | • | Ordered, human-readable steps for publishing the DNS the claim needs; empty when the platform manages the domain itself |
Try it
Claim a first-party tracking host under a product domain.