Sign in
Customer Privacy

Update customer privacy settings

Requires business:update. Send only revision and both complete country lists. Updates are optimistic: fetch the current settings, submit that revision, and refetch on 409 before reconciling changes. Valid codes are normalized to sorted unique lists. Saving increments revision, records an administrative audit and schedules invalidation of affected cached public pages/configuration across the business's domains. Cache propagation is asynchronous; success is not a guarantee that every edge has already refreshed. Do not echo the whole GET response or send owner-acceptance metadata.

patch/v3/customer-privacy

Request body

revisioninteger required

The revision returned by the most recent GET. A successful update increments it by one.

analytics_consent_countriesCustomerPrivacyCountryCode[] required

Use the supported codes returned by GET /v3/customer-privacy. Unsupported or lowercase codes are rejected. Duplicate valid codes are accepted and normalized to a sorted unique list.

marketing_consent_countriesCustomerPrivacyCountryCode[] required

Use the supported codes returned by GET /v3/customer-privacy. Unsupported or lowercase codes are rejected. Duplicate valid codes are accepted and normalized to a sorted unique list.

Response

Success

business_idinteger required
revisioninteger required

Current settings revision. Read it immediately before an update.

marketing_generationinteger required

Read-only revision for material marketing configuration changes.

notice_versionstring required

Current notice identifier.

analytics_enabledboolean required

Read-only legacy owner-acceptance metadata; not a writable analytics switch and not a prerequisite for event ingestion.

analytics_consent_countriesCustomerPrivacyCountryCode[] required

Use the supported codes returned by GET /v3/customer-privacy. Unsupported or lowercase codes are rejected. Duplicate valid codes are accepted and normalized to a sorted unique list.

marketing_consent_countriesCustomerPrivacyCountryCode[] required

Use the supported codes returned by GET /v3/customer-privacy. Unsupported or lowercase codes are rejected. Duplicate valid codes are accepted and normalized to a sorted unique list.

country_codesCustomerPrivacyCountryCode[] required

All supported country codes.

Changes

Changed in 1 of the 7 revisions of this API.1