Why Should I Connect Etsy?
When you connect your Etsy store:
You can push listings to Etsy from your panel
Automatic synchronization is activated
You can manage your store data from Listybox
Etsy orders appear in My Orders in Listybox
Prerequisites
Before connecting Etsy:
Active Etsy store - Must have seller account
Listybox account - At least FREE plan
Email verification - On both platforms
⚠️ Note: Connection cannot be established without an Etsy seller account.
Connection Steps
Step 1: Open the Stores Page
Open Settings > Stores in the app (app.listybox.com/settings/stores)
Click the button that connects Etsy
Read and accept the permissions window; the Etsy authorization page opens in a new tab
Step 2: Etsy OAuth Authorization
You'll be redirected to Etsy's official login page:
Log in with your Etsy account (if not already)
Review permission requests
Click the "Allow Access" button
Step 3: Shop Selection
If you have multiple Etsy shops:
Select the shop you want to connect
Click the "Connect Selected Shop" button
💡
Tip: Each shop requires a separate connection. If you want to connect more than one Etsy shop, we agree on the terms with you on a call.
OAuth Permissions
Listybox requests these Etsy permissions:
Permission | Purpose |
listings_r | Read existing listings |
listings_w | Create/edit new listings |
listings_d | Delete listings (optional) |
transactions_r | Read order data |
profile_r | Read shop profile info |
⚠️ Security: Listybox does not request access to your Etsy payment information or personal data.
Connection Statuses
Status | Meaning | Action |
Connected | Active connection | Normal use |
Token Expired | OAuth token expired | Reconnect |
Disconnected | Connection severed | Reconnect |
Suspended | Suspended by Etsy | Contact Etsy |
Store Connection Structure
Plans differ in daily capacity and in which generation features are open. We do not publish numeric limits. All plans: Plans at a Glance.
Note: Etsy is the only channel with a direct API connection. For Amazon US, Shopify and Walmart, you add the store for export and download your listings as a CSV or Excel file to upload yourself.
Note: If you want to connect more than one Etsy shop, we agree on the terms with you on a call.
Synchronization Settings
Set synchronization preferences after connection:
Setting Descriptions:
Auto-sync listings: Automatically push changes from Listybox
Sync frequency: How often to synchronize
Sync inventory: Sync stock/variation changes
Sync orders: Pull orders (for manual fulfillment)
Disconnecting
To disconnect Etsy:
Go to Settings > Stores
Click the "Disconnect" button next to the relevant shop
Select "Confirm Disconnect" in the confirmation window
⚠️ Warning: Disconnecting:
Stops push from Listybox to Etsy
Does not delete your existing Etsy listings
Does not delete your listing data in Listybox
Troubleshooting
"Connection Failed" Error
Possible Causes:
Pop-up blocker active
Etsy session closed
Network problem
Solution:
Disable pop-up blocker
Check your Etsy session
Refresh the page and try again
"Token Expired" Error
OAuth token times out after a certain period.
Solution:
Click the "Reconnect" button
Re-authorize on Etsy
Connection is renewed
"Shop Not Found" Error
Error message: No Etsy shop found for this account. Please create an Etsy shop first.
To connect Listybox, your Etsy account needs an open shop.
Possible Causes:
You have an Etsy account but have not opened a shop yet (the most common cause)
Logged in with the wrong Etsy account
The shop was closed or suspended
An Etsy account and an Etsy shop are not the same thing. Signing up on Etsy does not open a shop; you set the shop up separately.
Opening a shop:
Set up the shop from a web browser on a computer. Etsy runs shop setup in a computer browser; if you cannot open it on your phone, switch to a computer.
Start at etsy.com/sell and sign in with your Etsy account.
During setup Etsy may ask for billing details, a setup fee and identity verification. For current terms and amounts, see Etsy's own guide: How to Open an Etsy Shop.
While your shop is being opened, you can keep preparing your designs in Listybox.
Once the shop is open, return to Settings > Stores and connect Etsy again.
If your shop is already open:
Check that you are logged in with the correct Etsy account
Check in your Etsy seller dashboard that the shop is open
Security Information
Data Security:
All communication over HTTPS
OAuth 2.0 industry standard
Listybox does not store your Etsy password
Tokens stored encrypted
Permission Management:
You can also manage permissions from Etsy
Etsy > Settings > Apps and integrations
You can revoke access anytime
Frequently Asked Questions
Can I connect without an Etsy account?
No, an active Etsy seller account is required.
Is connection free?
Yes, Etsy connection is free on all plans.
Can I connect the same Etsy shop to multiple Listybox accounts?
No, each Etsy shop can only connect to one Listybox account.
Do I need to give my Etsy password to Listybox?
No, thanks to the OAuth system, you don't share your password. You only authorize on Etsy.
If I disconnect, will my Etsy listings be deleted?
No, your Etsy listings are not affected.
Related Articles
