Update listing import policy
Sets the linking policy for future imports of this Connection.
Change this setting before requesting import or reconciliation. The body has one decision, policy, but it has important effects on automatic Product, Variant, and binding creation for all future external offers of that Connection.
Choose unlinked for inspection first; match_only when your local SKUs/GTINs are reliable; and match_or_create when you accept minimum quarantine records for every variation that has no unique match. A title never enters the algorithm.
The change is local and returns the updated Connection. It does not start a Job, read the marketplace, change an existing Listing policy, or repair bindings already created. After changing it, deliberately import listings or reconcile.
api_keyAuthorizationBearer <token>API key (mk_...)
id*stringIdentifier of the resource, as returned by the API.
^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$uuidapplication/json- body
Replaces the listing import policy for this connection.
policy*stringExact-match behavior used when this connection imports listings.
"unlinked""match_only""match_or_create"The policy after the local change.
application/json- response
How listings imported from this connection may link to local variants. Matching is exact identifiers only; titles are never used.
policy*stringExact-match behavior used when this connection imports listings.
"unlinked""match_only""match_or_create"curl -X PATCH "https://example.com/v1/connections/3d1c8a52-7f0e-4b0a-8a65-9c1b2f6d7e01/listing-import-policy" \ -H "Content-Type: application/json" \ -d '{ "policy": "match_or_create" }'{ "policy": "match_or_create"}