megachangelog
Breaking2026.09.25

Google Sheets: Primary Identifier Mapping Required

Starting September 25, 2026, Google Sheets destination syncs require a primary identifier mapping to track row changes accurately. New syncs and edits to existing syncs must specify a unique source column as the key, either via the UI or API/Terraform with is_primary_identifier: true.

 

Changelog

  

Starting September 25, 2026, Google Sheets destination syncs require a primary identifier mapping: a unique key from your source data. We use it to track which rows are new or changed, so monthly active records are measured accurately. Syncs you don't touch keep running as they do today; this only applies to new syncs and edits to existing ones.

Pick a source column to use as the key in the UI when creating or editing a sync.

Action required if you use the API or Terraform Add a mapping with is_primary_identifier: true pointing to a source column that uniquely identifies each row. Starting September 25, calls that create or update a Google Sheets sync without this mapping will fail.

Want this turned on sooner? Contact Support and we can enable it early.

👉 Google Sheets destination documentation

google-sheetsdestinationssyncsbreakingapi

Source: original entry ↗