How to Connect Etsy to SellDeck

Why bring-your-own-key?

Etsy's API approval policy currently restricts third-party cross-listing tools as a category. SellDeck applied for production API access and was declined with no appeal channel. However, Etsy allows individual sellers to create their own developer apps for personal use — those are approved automatically.

The BYO key flow lets you create your own Etsy developer app under your account and connect it to SellDeck. The full integration code (listing sync, auto-delist, show pause/resume, and more) is already built and shipped — it just needs your credentials to work.

What you'll need

• An active Etsy seller account
• An active SellDeck account (any plan, including Free)
• About 10 minutes

Step 1: Create an Etsy developer app

1. Go to etsy.com/developers/your-apps and sign in with your Etsy seller account.
2. Click Create a New App.
3. Give it any name — "SellDeck Integration" or whatever you prefer. The name is only visible to you.
4. Select a category (any category works for personal use).
5. Describe your use case briefly: "Syncing my Etsy listings to my SellDeck account for inventory management and profit tracking."
6. Submit the form. Personal-use apps stay in "draft" status — that's normal and gives you full API access for your own shop.

Once created, you'll see your app's detail page with a Keystring and a Shared Secret. Keep this page open — you'll need both values.

Step 2: Set the callback URL

In your Etsy developer app settings, find the Callback URL field and paste this exact URL:

Without this exact URL, Etsy will refuse the OAuth handshake when you try to connect. Save your app settings after pasting it.

Step 3: Paste credentials into SellDeck

1. Log in to your SellDeck account.
2. Go to Marketplaces in the sidebar, find Etsy, and click Configure BYO Key.
3. Copy the Keystring from your Etsy developer app page and paste it into the Keystring field.
4. Copy the Shared Secret and paste it into the Shared Secret field.
5. Click Save Credentials.

Both values are encrypted before being stored. Your shared secret is never displayed back to you — treat it as write-only after saving.

Step 4: Connect your Etsy account

1. After saving credentials, you'll be redirected to the Marketplaces page.
2. Find Etsy and click Connect Etsy Account.
3. Etsy will open a new window asking you to authorize your own developer app against your shop.
4. Review the permissions and click Allow.
5. You'll be redirected back to SellDeck. Your Etsy integration is now active.

What works once connected

The Etsy integration behaves identically to a first-class API integration. Once connected, you get:

Troubleshooting

Etsy shows "Invalid callback URL"

Make sure you've copied the exact callback URL from Step 2 into your Etsy developer app settings. The URL must match character-for-character, including the protocol (https://) and trailing slash if present.

I saved credentials but "Connect Etsy Account" is still grayed out

Refresh the Marketplaces page. If it's still grayed out, double-check that both the keystring and shared secret were saved. Go back to the BYO setup page to verify — if the keystring is shown (masked), both values are saved. Try clearing and re-entering them.

My Etsy app is in "draft" status — is that a problem?

No. For personal-use apps, draft status is normal and gives you full API access to your own shop. You don't need to submit your app for review.

I want to disconnect Etsy from SellDeck

Go to the BYO setup page and click Remove Credentials. This deletes your saved credentials and disconnects the OAuth session. You can also revoke access from your Etsy developer console at any time.

Can I use SellDeck without Etsy integration?

Yes. SellDeck still tracks your Etsy inventory, calculates P&L, and prices items via AI without an API connection. You'll just need to manually mark items as sold on the Etsy side when they sell elsewhere. Many sellers start without the Etsy connection and add it later.