Etsy Integration Setup

📋Before You Start

• Active Etsy seller account with at least one active listing
• Etsy shop must be in good standing

🔧Setup Steps

1. 1
   Start the Etsy OAuth flow

   In Pythias, go to Admin → Integrations → Add New Integration → Etsy. Click Connect with Etsy. You will be redirected to Etsy's login page.
2. 2
   Sign in to Etsy and grant access

   Log in with your Etsy account. On the permissions screen, Pythias will request access to: read your listings, read and update your transactions (orders), and update shipping information. Click Allow access.
3. 3
   Select your Etsy shop

   If you manage multiple Etsy shops under one account, Pythias will list them. Select the shop(s) you want to connect to this Pythias account and click Save.
4. 4
   Test the connection

   Pythias will pull the last 10 open transactions from Etsy to verify the connection. Check that your recent paid, unshipped orders appear in the Pythias order queue. If they do not appear, check that they are in Paid or Processing status on Etsy (not Complete or Cancelled).

🔄What Gets Synced

• ✓Paid receipts / open transactions (pulled every 5 minutes)
• ✓Line items including listing title, personalization notes, quantity, and shipping address
• ✓Shipment tracking uploaded to Etsy receipt (marks order as shipped)
• ✓Order completion status update

💡Tips & Troubleshooting

• ⚡Etsy OAuth tokens are long-lived but can be revoked by the seller. If orders stop pulling, re-authorize from Admin → Integrations.
• ⚡Personalization notes (custom text orders) are included in the order details — make sure your team checks the notes column in the production queue.
• ⚡Etsy's Star Seller program requires shipping within your handling time. Set Pythias alerts for orders approaching their ship-by date.
• ⚡If you have digital + physical items in the same shop, use SKU-based routing rules to separate digital listings from physical production orders.