Get Tracking Settings

GET

api

tracking-settings

curl --request GET \
  --url https://api.sequenzy.com/api/v1/tracking-settings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/tracking-settings', 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-settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": true,
  "tracking": {
    "openTrackingEnabled": true,
    "clickTrackingEnabled": true,
    "transactionalOpenTrackingEnabled": false,
    "transactionalClickTrackingEnabled": false,
    "strictBotFilteringEnabled": false,
    "unsubscribeTrackingEnabled": true,
    "emailContentStorageEnabled": true,
    "defaultAttributionWindowHours": 24
  },
  "consent": {
    "doubleOptInEnabled": true,
    "doubleOptInEmailId": "email_abc123",
    "doubleOptInRedirectUrl": "https://example.com/welcome"
  },
  "autoUtm": {
    "enabled": true,
    "settings": { "source": "sequenzy", "medium": "email" }
  },
  "trackingDomain": {
    "domain": "links.acme.com",
    "status": "verified",
    "sslStatus": "active",
    "verifiedAt": "2026-02-02T11:00:00Z",
    "lastCheckedAt": "2026-05-01T06:00:00Z",
    "error": null
  },
  "replyTracking": {
    "inboundEmailEnabled": true,
    "inboundReplyDomainMode": "sequenzy",
    "forwardReplies": true
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

Get how a company measures email engagement - account-wide and Transactional API open/click defaults, unsubscribe tracking, the attribution window, automatic UTM tagging, the company tracking domain, and inbound reply tracking - plus whether new contacts must confirm their subscription. Use this to audit measurement readiness, to explain why opens or clicks are not being recorded, or to check how contacts enter the list before investigating bot or alias signups.

Request

curl "https://api.sequenzy.com/api/v1/tracking-settings" \
  -H "Authorization: Bearer YOUR_API_KEY"

Response fields

boolean

Whether open tracking pixels are injected.

boolean

Whether links are rewritten for click tracking.

boolean

Whether Transactional API sends include an open-tracking pixel by default. The account-wide openTrackingEnabled flag remains the master switch.

boolean

Whether Transactional API sends rewrite links for click tracking by default. The account-wide clickTrackingEnabled flag remains the master switch.

boolean

Opt-in aggressive bot detection at tracking ingest: strict user-agent patterns, datacenter and Microsoft Azure IPs, fast campaign and sequence clicks from IPs clicking other recipients’ emails, and cross-send IP sweeps. Off by default. Enabling it filters more security-scanner traffic but can also discard some real engagement, lowering reported open and click rates.

boolean

Whether to track unsubscribe link clicks. When false, Sequenzy unsubscribe links go directly to https://sequenzy.com, even with a custom tracking domain. Actual unsubscribes and their email attribution are still recorded.

boolean

Whether Sequenzy keeps each sent email’s content and subject, and the IP address, user agent and country of each open and click. Defaults to true. See Don’t store email content.

number

Hours after a send during which conversions are attributed to it.

Whether new contacts must confirm by email before they become subscribed. When enabled, contacts added by forms, the API, and integrations start pending until they click the confirmation email.

Confirmation email sent to pending contacts. null when double opt-in has never been enabled; enabling it provisions one automatically.

Where the hosted confirmation page sends subscribers after they confirm. null keeps them on the confirmation page, which is branded with the company’s name, logo, and colors.

boolean

Whether UTM parameters are appended to outbound links automatically.

object

Company tracking domain with its verification and SSL status. Every sending domain uses it for tracked links and opens. null means links use the shared Sequenzy tracking domain, as they also do while it is not verified. Manage it with Set Tracking Domain.

object

Inbound reply configuration: inboundEmailEnabled, inboundReplyDomainMode, and forwardReplies. inboundReplyDomainMode is custom when reply addresses use your verified receiving domain for emails from every sending domain, falling back to inbound.sequenzy.com until it is verified, or sequenzy to always use inbound.sequenzy.com. Adding your first receiving domain sets it to custom. Change it with replyTrackingDomainMode on Update Company.

Responses

{
  "success": true,
  "tracking": {
    "openTrackingEnabled": true,
    "clickTrackingEnabled": true,
    "transactionalOpenTrackingEnabled": false,
    "transactionalClickTrackingEnabled": false,
    "strictBotFilteringEnabled": false,
    "unsubscribeTrackingEnabled": true,
    "emailContentStorageEnabled": true,
    "defaultAttributionWindowHours": 24
  },
  "consent": {
    "doubleOptInEnabled": true,
    "doubleOptInEmailId": "email_abc123",
    "doubleOptInRedirectUrl": "https://example.com/welcome"
  },
  "autoUtm": {
    "enabled": true,
    "settings": { "source": "sequenzy", "medium": "email" }
  },
  "trackingDomain": {
    "domain": "links.acme.com",
    "status": "verified",
    "sslStatus": "active",
    "verifiedAt": "2026-02-02T11:00:00Z",
    "lastCheckedAt": "2026-05-01T06:00:00Z",
    "error": null
  },
  "replyTracking": {
    "inboundEmailEnabled": true,
    "inboundReplyDomainMode": "sequenzy",
    "forwardReplies": true
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

Get Tracking Settings

curl --request GET \
  --url https://api.sequenzy.com/api/v1/tracking-settings \
  --header 'Authorization: Bearer <token>'

const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.sequenzy.com/api/v1/tracking-settings', 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-settings",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>"
  ],
]);

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

curl_close($curl);

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

package main

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

func main() {

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

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")

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

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

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

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

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

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

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

{
  "success": true,
  "tracking": {
    "openTrackingEnabled": true,
    "clickTrackingEnabled": true,
    "transactionalOpenTrackingEnabled": false,
    "transactionalClickTrackingEnabled": false,
    "strictBotFilteringEnabled": false,
    "unsubscribeTrackingEnabled": true,
    "emailContentStorageEnabled": true,
    "defaultAttributionWindowHours": 24
  },
  "consent": {
    "doubleOptInEnabled": true,
    "doubleOptInEmailId": "email_abc123",
    "doubleOptInRedirectUrl": "https://example.com/welcome"
  },
  "autoUtm": {
    "enabled": true,
    "settings": { "source": "sequenzy", "medium": "email" }
  },
  "trackingDomain": {
    "domain": "links.acme.com",
    "status": "verified",
    "sslStatus": "active",
    "verifiedAt": "2026-02-02T11:00:00Z",
    "lastCheckedAt": "2026-05-01T06:00:00Z",
    "error": null
  },
  "replyTracking": {
    "inboundEmailEnabled": true,
    "inboundReplyDomainMode": "sequenzy",
    "forwardReplies": true
  }
}

{
  "success": false,
  "error": "Unauthorized"
}

{
  "success": false,
  "error": "API key is missing required scope: account:read"
}

​Request

​Response fields

​Responses

Request

Response fields

Responses