Etsy Integration
How Listing Liyo connects to your Etsy shop — and how to disconnect at any time.
About the Etsy API
The term “Etsy” is a trademark of Etsy, Inc. Listing Liyo uses Etsy's Open API to provide its service but is not endorsed or certified by Etsy, Inc. Listing Liyo is an independent application and is solely responsible for its features and data practices.
How We Connect to Etsy
Listing Liyo uses Etsy's official OAuth 2.0 authorization to connect to your shop. Here is the step-by-step flow:
- You click “Connect your Etsy shop” inside Listing Liyo.
- You are redirected to Etsy's official website where you log in using your own credentials.
- Etsy shows you a permissions screen explaining exactly what Listing Liyo is requesting access to.
- You click “Allow” on Etsy's page — or decline if you prefer not to proceed.
- Etsy sends an authorization token to Listing Liyo. We store this token securely and use it to make API calls on your behalf.
- Your shop data becomes accessible within Listing Liyo, and you can start managing your listings.
Listing Liyo never sees or stores your Etsy password. All credential handling is done by Etsy directly.
What Data We Access
We request only the minimum Etsy API scopes required to deliver the service:
| Scope | What It Allows | Why We Need It |
|---|---|---|
listings_r | Read your listing data | Display your listings in the Listing Liyo dashboard |
listings_w | Update your listing data | Apply edits you have reviewed and confirmed |
shops_r | Read your shop information | Display your shop name and identify your seller account |
shops_w | Update your shop information | Required for certain listing update operations via the API |
What Data We Do NOT Access
We are explicit about what we do not access. Listing Liyo does not request or read:
| Data Type | Why We Do Not Access It |
|---|---|
| Buyer information | Not needed for listing management |
| Order or transaction data | Not needed for listing management |
| Payment or financial records | Not needed for listing management |
| Etsy messages or conversations | Not needed for listing management |
| Customer addresses or personal data | Not needed for listing management |
| Billing or credit card data | Handled exclusively by Stripe |
Data Security Measures
We take the security of your data seriously. Our practices include:
- All data is transmitted over TLS 1.2 or higher (HTTPS).
- OAuth tokens are stored encrypted at rest and are never exposed in logs or client-facing responses.
- Listing data is cached for up to 6 hours and shop data for up to 24 hours to comply with Etsy API rate limits. Cached data is deleted when your account is removed.
- We retain your data for up to 30 days after account deletion, after which it is permanently purged.
- Access to production systems is limited to authorized personnel and is protected by multi-factor authentication.
How to Disconnect
You can disconnect Listing Liyo from your Etsy shop at any time using either of the following methods:
Option 1 — From within Listing Liyo:
Go to your Account Settings and click “Disconnect Etsy Shop.” This immediately revokes our OAuth token and removes your Etsy data from our systems.
Option 2 — From your Etsy account:
Log in to your Etsy account, navigate to Account Settings › Apps › Authorized Apps, and revoke access for Listing Liyo. Once revoked, Listing Liyo will no longer be able to make API calls on your behalf.
After disconnection, your cached listing data will be deleted from our servers within 7 days. Account data (your name, email, subscription status) is retained for up to 30 days then permanently deleted.