Prepare your Etsy shop
- Make sure you have an active Etsy shop with at least one published listing.
- Confirm your shop is set up to accept Etsy Payments (required for order ingestion).
- If you sell personalised items, make sure your personalisation fields are configured in Etsy — Huup imports them automatically.
Connect Etsy in Huup
- Sign in to app.huup.com.
- Open Integrations → Marketplace, click Add New Marketplace, pick Etsy.
- Click Connect to Etsy. A popup opens to Etsy — sign in and authorise Huup. You'll be redirected back automatically.
- Huup imports your shop info, listings (including personalisation fields), and the last 30 days of orders.
Running multiple Etsy shops? Repeat the same flow — each shop runs side by side in Huup with its own stock pool, pricing and branding.
What syncs after you connect
Create, edit and bulk-update listings with full variant, attribute and personalisation field support.
Real-time stock and price changes pushed to Etsy via OAuth-authenticated API calls.
Orders ingest with personalisation notes and gift options; dispatch carrier and tracking written back to the order on Etsy.
Issue full or partial refunds with Etsy reason codes — for personalisation mistakes or anything else.
Shop and listing reviews are pulled in next to the orders they came from.
Payments, adjustments and refunds are reconciled against each order.
Common issues
"Authorisation failed" after the popup
Make sure you signed in to the Etsy account that owns the shop you want to connect. Shop owners and shop admins both work; non-admin team members do not.
Personalisation fields not appearing on orders
Personalisation fields must be configured in Etsy's listing editor (the "Personalisation" toggle). Re-sync the listing from Catalog → Listings → Etsy → Sync after enabling.
Orders not coming through
Allow up to 10 minutes after first connection. Check Activity → Health — if Etsy API shows Unhealthy, contact support.
Stock changes not reflected on Etsy
Check the listing's last sync time in Catalog → Listings → Etsy. Etsy's API has lower rate limits than Amazon — bulk SKU changes are queued and may take a few minutes to flush.
Token expired notice
Etsy OAuth tokens expire periodically and Huup refreshes them automatically. If you see a token-expired banner, click Re-connect and walk through the popup once more.
The term 'Etsy' is a trademark of Etsy, Inc. This Application uses Etsy's API, but is not endorsed or certified by Etsy.
