API

OAuth

The standard way third-party apps connect to your Etsy shop without asking for your password.

Quick facts
  • Etsy version: OAuth 2.0
  • Flow: authorization code
  • Scopes: granular (you grant only the permissions an app needs)
  • Token expiry: access tokens expire; apps refresh automatically
  • Where to manage: Etsy account > Account settings > Apps

OAuth is the protocol your shop uses to grant permission to third-party tools (Everlyst, accounting software, inventory tools) without ever sharing your Etsy password. You sign in with Etsy directly; Etsy gives the app a scoped token; the app uses that token to act on your behalf.

Why this is the right way

  • No password sharing. Apps that ask for your Etsy login directly are a security nightmare and against Etsy TOS.
  • Granular scopes. When you authorize an app, Etsy lists exactly what it can do - read your listings, write your listings, read your orders, manage your shop. You can refuse if a scope feels excessive.
  • Revocable. You can revoke any app’s access from your Etsy account settings. The app stops working immediately.

Common scopes you’ll see

  • listings_r - read your listings
  • listings_w - create and edit your listings
  • transactions_r - read your orders
  • shops_r, shops_w - shop-level read/write

What to check before authorizing

  • Is the app listed in Etsy’s official directory? Apps not in the directory aren’t blocked, but the directory is a vetting layer.
  • Do the requested scopes match what the app actually does? An “analytics-only” app shouldn’t need write access.
  • Is the app’s privacy policy clear about data retention and resale? Especially important for tools that pull buyer info.

Revoking access

Etsy account > Settings > Apps. One click. The app’s access ends immediately, but data the app already pulled (analytics history, exports) usually persists in their system.

Tips
  • Audit your authorized apps annually. Tools you tried once still have shop access until you revoke.
How Everlyst helps

All Listings workspace

Search, sort, filter, and edit every listing in your shop from a single synced view - no more bouncing between Etsy tabs.

Ready to manage your Etsy catalog without the spreadsheet juggling?

Bulk edits with a review step. Built for sellers.

Join the waitlist for early access, founder-direct support, and locked-in launch pricing.