Mark Customer Pair as Not Duplicate
POST/api/v2/customers/dedup-decisions
Record a decision that two customers are not duplicates of each other, so the pair stops appearing in duplicate detection results. The decision is order-independent (the pair is stored with the lower ID first) and idempotent - repeating the call for the same pair returns the existing decision.
customers:writeGrant this scope to your token under Settings → Developer → Personal Access Tokens.
For scope 'qbo', the IDs refer to customer records synced from the connected QuickBooks Online instance identified by integration_instance_id.
Body fields:
- customer_id_a (integer, required): first customer of the pair.
- customer_id_b (integer, required): second customer of the pair; must differ from customer_id_a.
- scope (string, required): 'sku' or 'qbo'.
- integration_instance_id (integer, optional): the connected integration instance the decision applies to (used with scope 'qbo'); must reference an existing integration instance.
Authentication: Requires Bearer token with the customers read/write scope and the customer merge permission.
Request
Responses
- 200
- 401
- 403
- 422
- 429
OK
Response Headers
Unauthenticated — the bearer token is missing, revoked, expired, or malformed. Never retry automatically; fix the credential. See the Errors guide.
Forbidden — the token lacks a required scope, the endpoint is not available to API tokens, or the user behind the token lacks the permission. A human must adjust the token scopes or user permissions; do not retry.
Unprocessable Entity
Response Headers
Rate limited — platform limit is 1,000 requests/min; individual tokens may carry lower limits. Honor the Retry-After header before retrying. See the Rate Limits guide.