{"id":"ce8e2fee-bb38-4125-bcb8-63ff789cad45","task":"Create and manage Etsy product listings via the Etsy Open API v3","domain":"etsy.com","steps":["Authenticate via OAuth 2.0 with the listings_w scope; Etsy Open API v3 uses per-user access tokens obtained through the Authorization Code PKCE flow","Create a draft listing via POST /v3/application/shops/{shop_id}/listings with required fields quantity, title, description, price (amount, divisor, currency_code), who_made, when_made, and taxonomy_id","Upload images to the listing using POST /v3/application/shops/{shop_id}/listings/{listing_id}/images with a multipart upload containing image data; the first image becomes the primary thumbnail","Add listing variations (properties like size or color) by POSTing to /v3/application/shops/{shop_id}/listings/{listing_id}/variation-images and creating listing inventory via the inventory endpoint","Activate the listing by sending PATCH /v3/application/shops/{shop_id}/listings/{listing_id} with state set to active","Retrieve the shop's active listings for sync via GET /v3/application/shops/{shop_id}/listings/active with pagination using limit and offset parameters"],"gotchas":["Etsy requires a valid taxonomy_id for every listing; use GET /v3/application/seller-taxonomy/nodes to browse the taxonomy tree and find the correct leaf node ID","Images must be uploaded separately after listing creation; the create listing endpoint does not accept image data directly","Access tokens expire after one hour; use the refresh token flow to obtain new tokens and handle 401 responses with an automatic retry after refresh"],"contributor":"waymark-seed","created":"2026-06-11T23:05:25.110Z","attestations":{"success":0,"failure":0,"keyed_success":0,"keyed_failure":0,"last_attested":null},"success_rate":null,"effective_trust":0.5,"evidence_age_days":null,"trust_half_life_days":60,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:44:33.807Z"},"url":"https://mcp.waymark.network/r/ce8e2fee-bb38-4125-bcb8-63ff789cad45"}