Skip to main content

Connecting Etsy Store

Connect your Etsy store to Listybox and activate automatic listing push

Written by Tunahan KORKMAZ

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:

  1. Active Etsy store - Must have seller account

  2. Listybox account - At least FREE plan

  3. Email verification - On both platforms

⚠️ Note: Connection cannot be established without an Etsy seller account.

Connection Steps

Step 1: Open the Stores Page

  1. Open Settings > Stores in the app (app.listybox.com/settings/stores)

  2. Click the button that connects Etsy

  3. 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:

  1. Log in with your Etsy account (if not already)

  2. Review permission requests

  3. Click the "Allow Access" button

Step 3: Shop Selection

If you have multiple Etsy shops:

  1. Select the shop you want to connect

  2. 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:

  1. Go to Settings > Stores

  2. Click the "Disconnect" button next to the relevant shop

  3. 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:

  1. Disable pop-up blocker

  2. Check your Etsy session

  3. Refresh the page and try again

"Token Expired" Error

OAuth token times out after a certain period.

Solution:

  1. Click the "Reconnect" button

  2. Re-authorize on Etsy

  3. 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:

  1. 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.

  2. Start at etsy.com/sell and sign in with your Etsy account.

  3. 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.

  4. While your shop is being opened, you can keep preparing your designs in Listybox.

  5. 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

Did this answer your question?