> ## Documentation Index
> Fetch the complete documentation index at: https://www.foxreach.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Tracking Domains

> Bring your own open/click tracking domain, e.g. track.yourcompany.com.

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)

<ParamField body="domain" type="string" required>The subdomain to use for tracking links, e.g. `track.acme.com`.</ParamField>

Only one active domain per workspace at a time. Returns the domain with `status: "pending"` and a `cnameTarget` to point your DNS at.

```bash theme={null}
curl -X POST https://api.foxreach.io/api/v1/tracking-domains \
  -H "X-API-Key: YOUR_API_KEY" -H "Content-Type: application/json" \
  -d '{"domain": "track.yourcompany.com"}'
```

## 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.