Skip to main content

Bulk Update Etsy Listings

POST 
/api/etsy/instances/:integrationInstance/listings/bulk

Runs one action on many variations. A selected set of 50 or fewer runs immediately and returns the result; larger sets, filtered selections, and the map / create_products actions run in the background and return a tracked_job_log_id.

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

Request body:

  • action (string, required) — One of:
    • map — Link variations to SKU.io products with the same SKU.
    • create_products — Link by SKU, creating SKU.io products where none match.
    • unmap — Remove mappings.
    • enable_sync / disable_sync — Turn inventory push on/off for the parent listings.
    • archive / unarchive.
  • selection (object, required)
    • type (string, required) — selected or filtered.
    • ids (array of integers, required when type is selected) — Listing variation IDs (the id field).
    • filters (object, optional) — Same filter keys as List Etsy Listings without the filter[...] wrapper.

Immediate response fields: action, processed (variations considered), changed (variations affected), message.

Authentication: Bearer token (Personal Access Token).

delete removes the selected variations (and their SKU.io mappings) from SKU.io only — nothing changes on Etsy, and anything still listed on Etsy returns on the next catalog sync.

Request​

Responses​

OK

Response Headers
    Content-Type