Common Connection Problems
Issue | Possible Cause | Solution |
Connection won't start | Popup blocker | Allow popups |
"Access Denied" error | Permissions denied | Accept all permissions |
Token expired | OAuth token expired | Reconnect |
Store not showing | Sync error | Manual sync |
Connection dropping | Network issue | Check connection |
Error: "Authorization Failed"
Causes
Permissions Denied: Clicked "Deny" on Etsy authorization
Popup Blocked: Browser blocked popup window
Session Timeout: Authorization period expired
Wrong Etsy Account: Logged into wrong account
Solutions
Step 1: Allow Popups
Find popup block icon in browser address bar
Allow popups for Listybox
Refresh page
Try connecting again
Step 2: Correct Etsy Account
Go to Etsy.com
Verify you're logged into correct account
If wrong, log out and log into correct account
Return to Listybox and reconnect
Step 3: Accept All Permissions Accept these permissions on authorization screen:
✅ View your shops and listings
✅ Edit your listings
✅ View your transactions
✅ See your email address
Error: "Token Expired"
Cause
OAuth tokens expire after a period for security.
Solution
Go to Store Settings
Find affected store
Click "Reconnect"
Authorize on Etsy
Connection renewed
Error: "Store Not Found"
Causes
Store closed: Etsy store may be closed
Vacation mode: Store in vacation mode
API access revoked: Permissions revoked on Etsy
Solutions
Step 1: Check Etsy Store Status
Go to Etsy.com
Enter Shop Manager
Verify store is active
Turn off vacation mode if on
Step 2: Check API Permissions
Etsy → Account Settings → Apps
Check Listybox is listed
If not, reconnect from Listybox
Error: "Store Limit Exceeded"
Cause
You're trying to connect multiple stores from the same sales channel. All plans allow 1 store per channel. Store Structure:
All plans: 1 store/channel (currently Etsy only, other channels coming soon!)
Enterprise+: Unlimited stores
Solutions
Option 1: Remove Existing Store
Go to Store Settings
Disconnect store from the same channel
Connect new store
Option 2: Use Different Channel (Coming Soon)
Connect stores from different channels (Amazon, Trendyol coming soon!)
Option 3: Enterprise+ Upgrade
Upgrade to Enterprise+ for unlimited stores
Error: "Connection Timeout"
Causes
Slow internet: Low connection speed
Etsy API issues: Temporary Etsy outage
Firewall/VPN: Network restrictions
Solutions
Step 1: Check Internet
Check if other sites work
Toggle WiFi
Try different network
Step 2: Disable VPN/Firewall
Disable active VPN
Consult IT if behind corporate firewall
Step 3: Try Later
May be temporary Etsy issue
Wait 15-30 minutes and retry
Error: "Permission Denied"
Cause
Not all permissions were granted during connection.
Solution
Disconnect the store
Reconnect
Accept ALL permissions on authorization screen
Preventing Connection Issues
Regular Checks
Weekly: Run Store Health Check
Token expiry: Renew before expiration
Etsy updates: Follow Etsy changes
Browser Recommendations
Chrome: ✅ Best compatibility
Firefox: ✅ Works well
Safari: ⚠️ Check popup settings
Edge: ✅ Works well
Important Settings
✅ Allow popups
✅ Enable cookies
✅ Enable JavaScript
❌ Disable aggressive ad blockers
Contacting Support
If issue persists:
Take screenshot of error message
Save browser console logs (F12 > Console)
Note browser and version
Send to [email protected]
Or contact support via in-app chat.
Frequently Asked Questions
Will my listings be deleted if I disconnect?
No, data on both Etsy and Listybox is preserved.
Can I connect multiple Etsy accounts?
You can connect 1 store per channel. Enterprise+ is required for multiple stores from the same channel.
How long is token valid?
Usually 90 days. Auto-renews before expiry, sometimes manual renewal needed.
Does connection work in vacation mode?
Yes, connection works but listings aren't visible to customers.
I changed my Etsy account, what should I do?
Disconnect old account, connect with new account.
Related Articles
## Changelog
Versiyon | Tarih | Değişiklik | Yazar |
1.0.0 | 2025-12-09 | İlk sürüm | Listybox Team |