Start 'Connect with Etsy' (OAuth 2.0 + PKCE)
POST/api/channels/etsy/start
Parks the tenant, the chosen history window and a fresh PKCE
code_verifier under a single-use state for fifteen minutes and returns
Etsy's consent url, which the panel opens (doc 78 §2.1). Etsy redirects
the browser to GET /api/etsy/oauth/callback, which connects the shop
and sends the browser back to /settings?tab=channels with
etsy=connected, etsy=reconnected (the same shop, fresh tokens) or
etsy_error=<reason> (denied, missing_params, expired,
exchange, shop, no_shop, taken — the shop is connected to
another workspace; limit — the plan has no channel slot left).
Only read scopes are asked (shops_r transactions_r); nothing is ever written to Etsy. 422 on etsy when
the platform's Etsy app is not configured. Requires permission to
create channels.
Request
Responses
- 200
- 401
- 403
- 422
The consent url.
Not authenticated. code: account_disabled means the member's seat was deactivated in this workspace: the session is over even though the token was not revoked (clients sign out and clean up).
Authenticated but not allowed.
The request failed validation.