Skip to main content

Update Recovery Settings

PUT 

/api/amazon/unified/recovery/settings/:integrationInstance

Partially updates the Amazon Recovery settings for one Amazon integration. Every field is optional; only the fields you send are changed. Changes apply to opportunities found from now on — existing cases are not removed or re-evaluated. Requires the integrations update permission.

Required scope: recovery:write

Grant this scope to your token under Settings → Developer → Personal Access Tokens.

Request body fields:

  • enabled_categories (object, optional) — category key → boolean. Only the categories you name change; the rest keep their current toggle. Unknown category keys are rejected. Categories: warehouse_lost, warehouse_damaged, customer_return_not_received, customer_return_damaged, customer_return_refund_mismatch, inbound_shortage, removal_order_discrepancy, fba_fee_overcharge, chargeback_reversal, destroyed_without_authorization, return_not_restocked, underpaid_reimbursement, reimbursed_then_returned.
  • min_amount (number, optional, nullable, 0–1000000) — minimum potential amount for a new opportunity to be surfaced; null or 0 clears it.
  • default_assignee_user_id (integer, optional, nullable) — must be a member of the current account; null clears it.
  • weekly_digest_opt_in (boolean, optional).

Returns the full settings object (same shape as Get Recovery Settings).

  • discrepancy_settle_days (integer, optional, 0–60) — days an FBA loss or ledger discrepancy settles before it counts as unresolved. 422 outside 0–60.
  • reimbursement_cogs_enabled (boolean, optional) — post the cost of reimbursed units to COGS – FBA reimbursed units. Changing it (on or off) requires the accounting manage-settings permission; without it the request returns 422 on this field. Also returns 422 when turned on before that nominal code is mapped in the nominal code mapping settings.

Re-measurement settings (request: optional; response: always present):

  • remeasure_value_floor (number, default 50) — a re-measurement is worth one of Amazon's monthly slots only when correcting the size is worth at least this much a year (future fees saved + refundable overcharge).
  • remeasure_monthly_limit (integer, default 20) — Amazon's re-measurement limit per month.

Request​

Responses​

OK

Response Headers
    Content-Type