Adjust uploaded conversions

Retracts, restates the value of, or enhances conversions you already sent to Google Ads, for refunds or late customer data.

Adjust conversions that were previously uploaded via POST /v1/ads/conversions: retract them, restate their value, or enhance them with first-party data. Requires the Ads add-on.

Google Ads only. Google handles adjustments through the classic Google Ads API (ConversionAdjustmentUploadService); the Data Manager ingestEvents path used for sending conversions is ingest-only. Meta and LinkedIn have no equivalent, so this endpoint returns 405 for those platforms.

Adjustment types:

• RETRACTION: remove the conversion entirely (refund, chargeback, cancelled order, churn).
• RESTATEMENT: change the conversion's value (upgrade / downgrade / partial refund). Send the corrected total value in restatementValue (not a delta).
• ENHANCEMENT: attach first-party identifiers (hashed email / phone) to an existing conversion (enhanced conversions applied after the fact).

Identifying the original conversion (per adjustment):

• orderId: the transaction ID you sent as eventId on the original conversion. Recommended, and required for ENHANCEMENT.
• or gclid + conversionTime: the click ID and the original conversion's time (unix seconds). Not available for ENHANCEMENT.

destinationId is the conversion action resource name, e.g. customers/1234567890/conversionActions/987654321 (same value you send to POST /v1/ads/conversions). PII in user is hashed with SHA-256 server-side (Gmail-specific normalization included). Send plaintext.

Times are unix seconds; we convert to Google's required yyyy-MM-dd HH:mm:ss+00:00 format. Up to 2000 adjustments per request; partial failure is supported (inspect adjustmentsFailed / failures[]).