Set Tracking Domain

PUT

api

tracking-domain

Set Tracking Domain

curl --request PUT \
  --url https://api.sequenzy.com/api/v1/tracking-domain \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "<string>"
}
'

import requests

url = "https://api.sequenzy.com/api/v1/tracking-domain"

payload = { "domain": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domain: '<string>'})
};

fetch('https://api.sequenzy.com/api/v1/tracking-domain', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/tracking-domain",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/tracking-domain"

	payload := strings.NewReader("{\n  \"domain\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.sequenzy.com/api/v1/tracking-domain")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/tracking-domain")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Add a CNAME record for links.example.com pointing to links1.sequenzydns.com. Links use the shared tracking host until it verifies.",
  "trackingDomain": {
    "domain": "links.example.com",
    "status": "pending",
    "active": false,
    "everVerified": false,
    "sslStatus": "pending_validation",
    "verifiedAt": null,
    "lastCheckedAt": "2026-09-28T12:00:00Z",
    "error": null,
    "cnameRecord": {
      "type": "CNAME",
      "name": "links.example.com",
      "value": "links1.sequenzydns.com"
    }
  }
}

{
  "error": "Use a subdomain for tracking, for example links.acme.com."
}

{
  "error": "You have view-only access to this company. Contact the owner to request edit permissions."
}

{
  "error": "This tracking domain is already connected."
}

{
  "error": "Cloudflare for SaaS is not configured."
}

Set or change your company tracking domain. Every sending domain uses it for tracked links and opens, so you set it up once.

Any subdomain you control works, for example links.example.com. It does not have to share a root with your sending domains. A bare domain such as example.com is rejected because most DNS providers cannot hold a CNAME there.
After saving, publish the returned trackingDomain.cnameRecord. Sending never waits for it: new emails use Sequenzy’s shared tracking domain until it verifies. Check it right away with Verify Tracking Domain.
Saving the current hostname again only rechecks it.
Changing to a new hostname restarts verification for the new one. The previous hostname keeps serving links in emails you already sent, as long as you keep its old CNAME record.

Requires the companies:manage scope and owner or admin access.

Request

curl -X PUT "https://api.sequenzy.com/api/v1/tracking-domain" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "domain": "links.example.com" }'

Body

string

required

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

Response fields

string

The next step, usually the CNAME record to add.

object

The saved tracking domain. See Get Tracking Domain for its fields.

{
  "success": true,
  "message": "Add a CNAME record for links.example.com pointing to links1.sequenzydns.com. Links use the shared tracking host until it verifies.",
  "trackingDomain": {
    "domain": "links.example.com",
    "status": "pending",
    "active": false,
    "everVerified": false,
    "sslStatus": "pending_validation",
    "verifiedAt": null,
    "lastCheckedAt": "2026-09-28T12:00:00Z",
    "error": null,
    "cnameRecord": {
      "type": "CNAME",
      "name": "links.example.com",
      "value": "links1.sequenzydns.com"
    }
  }
}

{
  "error": "Use a subdomain for tracking, for example links.acme.com."
}

{
  "error": "You have view-only access to this company. Contact the owner to request edit permissions."
}

{
  "error": "This tracking domain is already connected."
}

{
  "error": "Cloudflare for SaaS is not configured."
}

A 503 means the tracking provider could not register the hostname. Nothing was saved, so you can retry the same request.

Set Tracking Domain

curl --request PUT \
  --url https://api.sequenzy.com/api/v1/tracking-domain \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "domain": "<string>"
}
'

import requests

url = "https://api.sequenzy.com/api/v1/tracking-domain"

payload = { "domain": "<string>" }
headers = {
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.put(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'PUT',
  headers: {Authorization: 'Bearer <token>', 'Content-Type': 'application/json'},
  body: JSON.stringify({domain: '<string>'})
};

fetch('https://api.sequenzy.com/api/v1/tracking-domain', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.sequenzy.com/api/v1/tracking-domain",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "PUT",
  CURLOPT_POSTFIELDS => json_encode([
    'domain' => '<string>'
  ]),
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "Content-Type: application/json"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"strings"
	"net/http"
	"io"
)

func main() {

	url := "https://api.sequenzy.com/api/v1/tracking-domain"

	payload := strings.NewReader("{\n  \"domain\": \"<string>\"\n}")

	req, _ := http.NewRequest("PUT", url, payload)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("Content-Type", "application/json")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.put("https://api.sequenzy.com/api/v1/tracking-domain")
  .header("Authorization", "Bearer <token>")
  .header("Content-Type", "application/json")
  .body("{\n  \"domain\": \"<string>\"\n}")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.sequenzy.com/api/v1/tracking-domain")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Put.new(url)
request["Authorization"] = 'Bearer <token>'
request["Content-Type"] = 'application/json'
request.body = "{\n  \"domain\": \"<string>\"\n}"

response = http.request(request)
puts response.read_body

{
  "success": true,
  "message": "Add a CNAME record for links.example.com pointing to links1.sequenzydns.com. Links use the shared tracking host until it verifies.",
  "trackingDomain": {
    "domain": "links.example.com",
    "status": "pending",
    "active": false,
    "everVerified": false,
    "sslStatus": "pending_validation",
    "verifiedAt": null,
    "lastCheckedAt": "2026-09-28T12:00:00Z",
    "error": null,
    "cnameRecord": {
      "type": "CNAME",
      "name": "links.example.com",
      "value": "links1.sequenzydns.com"
    }
  }
}

{
  "error": "Use a subdomain for tracking, for example links.acme.com."
}

{
  "error": "You have view-only access to this company. Contact the owner to request edit permissions."
}

{
  "error": "This tracking domain is already connected."
}

{
  "error": "Cloudflare for SaaS is not configured."
}

​Request

​Body

​Response fields

Request

Body

Response fields