ShipWave Channels

Connecting Etsy

Connect your Etsy shop to list handmade and vintage items.

Requirements

To connect Etsy to ShipWave, you need:
  • An active Etsy shop – Your shop must be open and in good standing
  • Shop owner access – You must be the shop owner (not a collaborator with limited permissions)
  • Physical products – ShipWave creates "physical" listings (not digital downloads)

Step-by-step connection

  1. Go to Admin → Marketplace → Channels and click New Channel
  2. Select Etsy as the platform
  3. Choose which Shopify store to use as the product source
  4. Name your channel (e.g., "Etsy Shop")
  5. Click Create Channel, then Connect
  6. You'll be redirected to Etsy's authorization page
  7. Sign in with your Etsy credentials
  8. Select which shop to connect (if you have multiple)
  9. Review and accept the permissions
  10. Click Allow access
  11. You'll be redirected back to ShipWave with the channel now connected

OAuth with PKCE

Etsy uses OAuth 2.0 with PKCE (Proof Key for Code Exchange) for enhanced security. This means:
  • Authorization is handled entirely through Etsy's secure login page
  • ShipWave never sees your Etsy password
  • A unique code verifier is generated for each authorization attempt
  • Tokens are stored encrypted in ShipWave

Etsy listing specifics

Etsy has unique listing requirements:
  • Who made it? – "I did" (handmade), "A member of my shop" (handmade), "Another company" (supply or vintage)
  • What is it? – "A finished product", "A supply or tool", etc.
  • When was it made? – Required for handmade items
  • Tags – Up to 13 tags for search optimization
  • Materials – List materials used (important for handmade items)
ShipWave sets sensible defaults, but you can customize these per-listing.

Etsy shipping profiles

Etsy listings require a shipping profile. You can:
  • Use your default Etsy shipping profile
  • Specify a shipping profile ID in ShipWave
  • Set processing time per-listing
Shipping costs are calculated by Etsy based on your profile settings.

Etsy categories

Etsy has its own category taxonomy. When you create a listing, ShipWave attempts to map your Shopify product type to an Etsy category. You can also set categories manually per-listing or create category mappings for bulk assignments.

Troubleshooting

Error: "Shop not found"
  • Ensure you selected a shop during authorization
  • Your shop must be open (not on vacation mode or suspended)
Error: "Insufficient permissions"
  • You must be the shop owner to connect
  • Collaborators with limited permissions cannot authorize third-party apps
Token expired
  • Etsy tokens expire after a period of inactivity. Reconnect the channel to refresh.

FAQs

Can I connect multiple Etsy shops?
Yes. Create a separate channel for each Etsy shop.
Does ShipWave support Etsy digital downloads?
No. ShipWave only supports physical product listings. Digital downloads must be managed directly in Etsy.
How do Etsy listing fees work?
Etsy charges a $0.20 listing fee per item. This fee is charged by Etsy to your Etsy account, not by ShipWave.
Can I use Etsy Ads with ShipWave listings?
Yes. Listings created through ShipWave can be promoted using Etsy Ads, which you manage in your Etsy Shop Manager.

More in ShipWave Channels

Back to Help Center