Interactive Etsy API v3 Reviewer Sandbox (Synthetic Data)No credentials required. Test OAuth 2.0 PKCE consent, SKU stock deltas, and
createReceiptShipment tracking submission live.ArtisanWoodcraftStudio
Shop ID: 48291044Connected via Etsy Open API v3AES-256-GCM Server-SideListings TTL: 42m / 6h maxTLS 1.3 · PKCE S256
OAuth 2.0 + PKCE (S256)Connected via Etsy Open API v3
Etsy Open API v3 Connection & Scope Authorization
LoomSync Studio connects strictly through Etsy's official OAuth 2.0 authorization server using PKCE code_challenge_method=S256 and CSRF state verification. We never collect or store Etsy account passwords, and tokens are encrypted server-side in PostgreSQL using AES-256-GCM.
Connected Shop
ArtisanWoodcraftStudio
Shop ID: 48291044
Token Vault Encryption
AES-256-GCM Server-Side
Zero browser/localStorage exposure
API Cache Freshness
Listings ≤ 6h · Other ≤ 24h
Compliant with Etsy API Terms
Buyer Email Scope
Not Requested
Zero off-platform marketing policy
Scope-to-Endpoint Permission Matrix (5 OAuth Scopes + createReceiptShipment)
Every requested scope maps directly to a seller-initiated B2B inventory or order fulfillment workflow.
| Scope / Permission | Access | Etsy Open API v3 Endpoint(s) | Operational Purpose | Freshness & Retention |
|---|---|---|---|---|
shops_rShop Profile & Performance | Read | GET /v3/application/shops/{shop_id} | Retrieve verified Etsy shop identity, storefront currency, active listing count, and fulfillment SLA metrics. | Refreshed every 60m; max cache TTL <= 24 hours. |
listings_rCatalog & Inventory Read | Read | GET /v3/application/shops/{shop_id}/listings & /listings/{listing_id}/inventory | Import active/inactive listings, variant matrices, SKU codes, and live Etsy quantities for reconciliation. | Refreshed on demand; max cache TTL <= 6 hours. |
listings_wInventory Stock Reconciliation | Write | PUT /v3/application/listings/{listing_id}/inventory | Push seller-confirmed warehouse stock quantities back to existing Etsy SKUs to prevent overselling. Never creates duplicate listings. | Triggered exclusively by explicit inventory sync rules. |
transactions_rOrder Receipts & Personalization | Read | GET /v3/application/shops/{shop_id}/receipts | Fetch paid shop receipts, line-item SKUs, shipping destination, and buyer personalization notes for workshop production. | Buyer PII auto-purged 30–90 days post-completion (24h on disconnect). |
transactions_wOrder Status & Fulfillment | Write | PUT /v3/application/shops/{shop_id}/receipts/{receipt_id} | Confirm shipped status and synchronize verified workshop dispatch updates back to the Etsy seller order. | Write-through only upon explicit seller confirmation. |
createReceiptShipmentCarrier & Tracking Submission | Endpoint Approval | POST /v3/application/shops/{shop_id}/receipts/{receipt_id}/tracking | Submit carrier code and validated tracking number so Etsy triggers the official buyer shipping notification. | Audit payload retained without unmasked buyer PII. |
Live Etsy Open API v3 Sandbox Event Log
09:41:12 UTCGET
/v3/application/shops/48291044/listings?state=activelistings_r200 OKFetched 6 listings (24 variants). Cache TTL reset to 6h window.
09:38:04 UTCGET
/v3/application/shops/48291044/receipts?was_paid=truetransactions_r200 OKImported 4 paid receipts with personalization notes.
08:15:47 UTCPOST
/v3/application/shops/48291044/receipts/3491820290/trackingcreateReceiptShipment200 OKSubmitted USPS tracking 9405511899223847102941 for #3491820290.