---
title: "Update tracking settings"
method: PATCH
path: "/tracking-settings"
tags: ["Tracking Settings"]
---

# Update tracking settings

`PATCH /tracking-settings`

Updates the account-wide tracking defaults - open, click, and unsubscribe tracking, strict bot filtering, the default attribution window, and automatic UTM tagging. Applies to emails sent afterwards; already-sent emails keep the links they were rendered with. Reply tracking is updated through the company endpoint.

## Request body

- object
  - `openTrackingEnabled` boolean — Whether to embed the open-tracking pixel.
  - `clickTrackingEnabled` boolean — Whether to rewrite links through the click-tracking redirect.
  - `strictBotFilteringEnabled` boolean — Opt-in aggressive bot detection (strict user-agent patterns, datacenter IPs, cross-send IP sweeps). Off by default; enabling it can lower reported open and click rates.
  - `unsubscribeTrackingEnabled` boolean — Whether unsubscribe links are attributed to the email that produced them.
  - `defaultAttributionWindowHours` integer — Default revenue attribution window in hours.
  - `autoUtmEnabled` boolean — Whether UTM parameters are appended to outbound links automatically. Enabling this with no stored parameters seeds the platform defaults.
  - `autoUtmSettings` object, nullable — UTM templates merged over the stored ones. Null resets every parameter to the platform defaults; a null field stops that parameter being emitted.
    - `source` string, nullable
    - `medium` string, nullable
    - `campaign` string, nullable
    - `content` string, nullable
    - `term` string, nullable

## Response `200`

Tracking configuration updated

- object
  - `success` boolean
  - `tracking` object
    - `openTrackingEnabled` boolean
    - `clickTrackingEnabled` boolean
    - `strictBotFilteringEnabled` boolean — Opt-in aggressive bot detection (strict user-agent patterns, datacenter IPs, cross-send IP sweeps). Off by default; enabling it can lower reported open and click rates.
    - `unsubscribeTrackingEnabled` boolean
    - `defaultAttributionWindowHours` integer
  - `autoUtm` object
    - `enabled` boolean
    - `settings` object
  - `trackingDomain` object, nullable — Null when click links use the shared Sequenzy tracking domain.
    - `domain` string
    - `status` string
    - `sslStatus` string, nullable
    - `verifiedAt` string, date-time, nullable
    - `lastCheckedAt` string, date-time, nullable
    - `error` string, nullable
  - `replyTracking` object
    - `inboundEmailEnabled` boolean
    - `inboundReplyDomainMode` string
    - `forwardReplies` boolean
  - `message` string

## Other responses

- `400` — Validation error
- `401` — Unauthorized
- `404` — Company not found

## Changes

- **2026-08-02** `36f92fc0caa2` — 3 breaking
  - the response property `success` became optional for the status `400`
  - the response property `success` became optional for the status `401`
  - the response property `success` became optional for the status `404`
- **2026-07-29** `d03612b5fabd` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/sequenzy/apis/sequenzy-api/changes/tracking-settings/patch.md)

---

[API](https://skmtc.dev/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.dev/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/revisions/36f92fc0caa2/schema)