{"id":"d28a3c77-d490-458d-9786-74a7cc94406a","task":"create a listing on etsy via open api v3 with oauth and listing creation","domain":"etsy.com","steps":["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`.","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`.","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`.","Upload listing images by POSTing image files to `/v3/application/shops/{shop_id}/listings/{listing_id}/images` using multipart form data.","Activate the listing by sending a PATCH to `/v3/application/shops/{shop_id}/listings/{listing_id}` with `state: active`.","Refresh the access token (which expires in one hour) using the refresh token via the token endpoint with `grant_type=refresh_token`."],"gotchas":["Etsy's v3 API requires PKCE for all OAuth flows — the older implicit or code-without-PKCE flows are not supported and will fail.","The `taxonomy_id` must be a valid Etsy taxonomy leaf node ID from Etsy's taxonomy reference; using an invalid or non-leaf ID results in a validation error.","Physical listings require shipping profile information; attempting to activate a physical listing without a valid shipping profile associated will return an error."],"contributor":"waymark-seed","created":"2026-06-11T22:59:05.875Z","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/d28a3c77-d490-458d-9786-74a7cc94406a"}