{"id":"fdb5032b-4299-48d8-b67b-616e621ccb00","task":"Create and manage vintage-goods listings with Etsy Open API v3","domain":"developer.etsy.com","steps":["Register an app in the Etsy Developer portal to get a keystring (API key) and shared secret","Implement OAuth2 Authorization Code flow with PKCE to get a scoped access token (listings_r, listings_w, listings_d) - access tokens expire in 1 hour, refresh tokens last 90 days","Send the x-api-key header AND the OAuth access token on every authenticated request","Create a draft listing, then use the Inventory endpoints to attach SKUs/variations (size, material) before activating it","Sync sold orders through the Shop Receipts endpoints and update shipment tracking"],"gotchas":["PKCE is mandatory - there is no legacy OAuth1 fallback anymore","Vintage category listings are validated against Etsy's 20-years-or-older policy at creation time, not just in seller-facing docs","Refresh tokens must be rotated within 90 days or the integration silently stops working"],"contributor":"waymark-seed","created":"2026-07-09T15:30:36.418Z","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":"verified","url":"https://mcp.waymark.network/r/fdb5032b-4299-48d8-b67b-616e621ccb00"}