Tracking Domain

Set tracking domain

Changed on

Sets or changes the company tracking domain. Any subdomain the caller controls works, including one on a root other than the sending domains; a bare registrable domain is rejected because it cannot hold a CNAME. Publish the returned cnameRecord. Sending never waits for it; new emails use the shared Sequenzy tracking domain until it verifies. Saving the current hostname again only rechecks it. Changing the hostname keeps the previous one serving links in emails already sent while its old CNAME stays. Requires the companies:manage scope plus owner or admin access.

put/tracking-domain

Request

  • Base URL
    https://api.sequenzy.com/api/v1
  • URL
    https://api.sequenzy.com/api/v1/tracking-domain
  • Auth
    HTTP bearer

Request body

domainstring required

Tracking hostname, a subdomain such as links.example.com. A leading https:// and trailing path are ignored.

Response

Tracking domain saved

successboolean
messagestring

The next step, usually the CNAME to add.

Example response

{
  "trackingDomain": {
    "domain": "links.example.com",
    "cnameRecord": {
      "name": "links.example.com",
      "value": "links1.sequenzydns.com"
    }
  }
}

Changes