LoomSync Studio
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 v3
AES-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 / PermissionAccessEtsy Open API v3 Endpoint(s)Operational PurposeFreshness & Retention
shops_r
Shop Profile & Performance
ReadGET /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_r
Catalog & Inventory Read
ReadGET /v3/application/shops/{shop_id}/listings & /listings/{listing_id}/inventoryImport active/inactive listings, variant matrices, SKU codes, and live Etsy quantities for reconciliation.Refreshed on demand; max cache TTL <= 6 hours.
listings_w
Inventory Stock Reconciliation
WritePUT /v3/application/listings/{listing_id}/inventoryPush 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_r
Order Receipts & Personalization
ReadGET /v3/application/shops/{shop_id}/receiptsFetch 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_w
Order Status & Fulfillment
WritePUT /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.
createReceiptShipment
Carrier & Tracking Submission
Endpoint ApprovalPOST /v3/application/shops/{shop_id}/receipts/{receipt_id}/trackingSubmit 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

3 recorded operations
09:41:12 UTCGET/v3/application/shops/48291044/listings?state=activelistings_r200 OK

Fetched 6 listings (24 variants). Cache TTL reset to 6h window.

09:38:04 UTCGET/v3/application/shops/48291044/receipts?was_paid=truetransactions_r200 OK

Imported 4 paid receipts with personalization notes.

08:15:47 UTCPOST/v3/application/shops/48291044/receipts/3491820290/trackingcreateReceiptShipment200 OK

Submitted USPS tracking 9405511899223847102941 for #3491820290.