Etsy · Authentication Profile

Etsy Authentication

Authentication

Etsy secures its APIs with apiKey and oauth2 across 2 declared security schemes, as derived from its OpenAPI definitions. OAuth 2.0 is offered via the authorizationCode flow(s).

MarketplaceEcommerceHandmadeListingsOrdersPaymentsReviewsShippingTaxonomyOAuth2
Methods: apiKey, oauth2 Schemes: 2 OAuth flows: authorizationCode API key in: header

Security Schemes

api_key apiKey
· in: header (x-api-key)
oauth2 oauth2
· flows: authorizationCode

Source

Authentication Profile

Raw ↑ 
generated: '2026-07-11'
method: derived
source: openapi/etsy-openapi-original.yml
summary:
  types:
  - apiKey
  - oauth2
  api_key_in:
  - header
  oauth2_flows:
  - authorizationCode
schemes:
- name: api_key
  type: apiKey
  in: header
  parameter: x-api-key
  description: Every request to a v3 API endpoint must include this data in the format `keystring:shared_secret`.
    Your keystring and shared secret are available on the [Your Apps](https://www.etsy.com/developers/your-apps)
    page.
  sources:
  - openapi/etsy-openapi-original.yml
- name: oauth2
  type: oauth2
  flows:
  - flow: authorizationCode
    authorizationUrl: https://www.etsy.com/oauth/connect
    tokenUrl: https://openapi.etsy.com/v3/public/oauth/token
    scopes: 20
  description: Open API v3 supports authenticating via OAuth 2.0. More information about Etsy's
    specific implementation of OAuth2 can be found [here](/documentation/essentials/oauth2).
  sources:
  - openapi/etsy-openapi-original.yml