Sales Channels

Connecting Etsy

Etsy exposes a modern Open API v3 surface. EcomFlux connects with OAuth 2.0 (including PKCE where required) so you authorize the app once and we rotate access tokens in the background for receipts, transactions, and listing-related reads your scopes allow.

Prerequisites

  • An Etsy shop and a user who can install third-party apps.
  • An app registered in Etsy Developers with redirect URLs that match your EcomFlux API / dashboard environment.
  • Scopes that cover read (and write where needed) receipts and transactions for the order flows you run — tighten scopes to the minimum your ops team needs.

Connect from Channels

  1. Open Dashboard → Channels.
  2. Choose the Etsy card and click Connect.
  3. When an Etsy SalesChannel already exists, EcomFlux requests an install ticketand sends you to Etsy's consent screen; approve to bind the shop.
  4. On first setup, you may paste keystring (client id), shared secret (if your flow is confidential), and complete OAuth; after authorization, shop id and token pairs are stored on the channel for the universal adapter to refresh.
  5. Trigger or wait for sync; new receipts should map into standard orders in Orders.

Tip:If consent fails, verify the Etsy app's callback URL and that the shop owner approving the app matches the shop you intend to sync.

Related