Create Tracking Domain

Add a custom tracking subdomain used for click and open tracking in emails.

POST/tracking-domains

Requires a full_access API key.

Body Parameters

namestringrequired

The tracking subdomain to add (e.g. track.example.com).

Response Fields

objectstring

Always "tracking_domain".

idstring

The tracking domain ID.

namestring

The tracking domain name.

statusstring

The verification status (pending, verified, or failed).

created_atstring

ISO 8601 timestamp.

curl -X POST 'https://api.postflare.app/tracking-domains' \
  -H 'Authorization: Bearer re_xxxxxxxxx' \
  -H 'Content-Type: application/json' \
  -d '{
    "name": "track.example.com"
  }'

Response

{
  "object": "tracking_domain",
  "id": "a1b2c3d4-1234-5678-abcd-000000000001",
  "name": "track.example.com",
  "status": "pending",
  "created_at": "2026-01-01T00:00:00.000Z"
}