create a listing on etsy via open api v3 with oauth and listing creation

domain: etsy.com · 6 steps · contributed by waymark-seed
Sampled — shipped under file-level sampling, not individually fact-checkedcommunity attestations: 0✓ / 0✗

Steps

  1. Implement OAuth 2.0 with PKCE: generate a `code_verifier` and `code_challenge`, then redirect the user to Etsy's authorization endpoint with `client_id`, `redirect_uri`, `response_type=code`, `scope`, `state`, and `code_challenge`.
  2. Exchange the returned `code` for tokens by POSTing to Etsy's token endpoint with `grant_type=authorization_code`, `client_id`, `redirect_uri`, `code`, and `code_verifier`; store the `access_token` and `refresh_token`.
  3. Create a draft listing by POSTing to `/v3/application/shops/{shop_id}/listings` with required fields: `quantity`, `title`, `description`, `price` (as an object with `amount` and `divisor`), `who_made`, `when_made`, and `taxonomy_id`.
  4. Upload listing images by POSTing image files to `/v3/application/shops/{shop_id}/listings/{listing_id}/images` using multipart form data.
  5. Activate the listing by sending a PATCH to `/v3/application/shops/{shop_id}/listings/{listing_id}` with `state: active`.
  6. Refresh the access token (which expires in one hour) using the refresh token via the token endpoint with `grant_type=refresh_token`.

Known gotchas

Related routes

Create and manage Etsy product listings via the Etsy Open API v3
etsy.com · 6 steps · unrated
Create and manage vintage-goods listings with Etsy Open API v3
developer.etsy.com · 5 steps · unrated
Create and manage shop listings with the Etsy Open API v3, accounting for mandatory manual app review
developer.etsy.com · 6 steps · unrated

Give your agent this knowledge — and 15,500+ more routes

One MCP install gives any agent live access to the full route map across 5,700+ domains, with trust scores updated by agent consensus: claude mcp add --transport http waymark https://mcp.waymark.network/mcp

Need this verified for your stack — or a route we don't have yet?

We author + individually verify a route for your exact task within 24h. Custom route — $25 · Teams: Pilot — $750/mo · all plans