---
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 - plus the double opt-in requirement for new contacts. 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.
  - `doubleOptInEnabled` boolean — Whether new contacts must confirm by email before they become subscribed. This is the account-wide default that the per-request optInMode on subscriber creation overrides. Enabling it requires a sender profile and provisions the confirmation email automatically; it does not change contacts that are already active.
  - `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
  - `consent` object — Signup consent settings, as opposed to engagement measurement.
    - `doubleOptInEnabled` boolean — Whether new contacts must confirm by email before they become subscribed. When on, contacts added by forms, the API, and integrations start pending and are never sent marketing email until they confirm.
    - `doubleOptInEmailId` string, nullable — Confirmation email sent to pending contacts. Null when double opt-in has never been enabled; enabling it provisions one automatically.
  - `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

---

[API](https://skmtc.net/sequenzy/apis/sequenzy-api.md) · [All operations](https://skmtc.net/sequenzy/apis/sequenzy-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sequenzy/sequenzy-api/versions/af1cf9620482/schema)