API referenceTracking Domains
Add a tracking domain
A hostname of the brand’s own (`links.acme.com`): set its CNAME to the shared domain, then check it. Links move to it once it’s active.
POST
A hostname of the brand’s own (links.acme.com): set its CNAME to the shared domain, then check it. Links move to it once it’s active.
idempotency-key?stringRun this write once: a retry with the same key gets the first answer (24 hours).
Length
1 <= length <= 255application/json- body
hostname*stringMatch
^(?=.{3,253}$)([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z]{2,63}$Created
application/json- response
id*stringFormat
uuidhostname*stringstatus*stringValue in
"pending""active""failed"cnameTarget*stringdetail*string|nullcheckedAt*|Format
date-timecreatedAt*stringFormat
date-timecurl -X POST 'https://api.postforge.dev/v1/tracking-domains' \ -H 'Content-Type: application/json' \ -d '{ "hostname": "string"}'{ "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "hostname": "string", "status": "pending", "cnameTarget": "string", "detail": "string", "checkedAt": "2019-08-24T14:15:22Z", "createdAt": "2019-08-24T14:15:22Z"}