Skip to main content
Returns 501 when custom tracking domains are not configured on this environment (dev/local by default).

List domains

GET /api/v1/tracking-domains (read): {"domains": [...], "defaultDomain": "foxtrk.com", "configured": true}.

Add a domain

POST /api/v1/tracking-domains (write)
string
required
The subdomain to use for tracking links, e.g. track.acme.com.
Only one active domain per workspace at a time. Returns the domain with status: "pending" and a cnameTarget to point your DNS at.

Verify a domain

POST /api/v1/tracking-domains/{id}/verify (write): re-checks DNS/SSL provisioning status.

Delete a domain

DELETE /api/v1/tracking-domains/{id} (write): sending reverts to the shared tracking domain.