Connections

Update listing import policy

Sets the linking policy for future imports of this Connection.

PATCH
/v1/connections/{id}/listing-import-policy

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.

Authorization

api_key
headerAuthorizationBearer <token>

API key (mk_...)

Path Parameters

id*string

Identifier of the resource, as returned by the API.

Match^([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)$
Formatuuid

Request Body

application/json
  1. body

Replaces the listing import policy for this connection.

policy*string

Exact-match behavior used when this connection imports listings.

Value in"unlinked""match_only""match_or_create"

Response Body

The policy after the local change.

application/json
  1. response

How listings imported from this connection may link to local variants. Matching is exact identifiers only; titles are never used.

policy*string

Exact-match behavior used when this connection imports listings.

Value in"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"}