Etsy · OAuth Scopes

Etsy OAuth Scopes

OAuth 2.0 derived

Etsy publishes 20 OAuth 2.0 scopes via the authorizationCode flow. Scopes are the fine-grained permissions an application requests at authorization time to act against the Etsy API on a user’s behalf.

Tokens are issued from https://openapi.etsy.com/v3/public/oauth/token.

This index is generated from the provider’s OpenAPI security definitions (and, where available, its documented scope reference) and refreshes on every APIs.io network build. Browse every provider’s scopes at scopes.apis.io.

MarketplaceEcommerceHandmadeListingsOrdersPaymentsReviewsShippingTaxonomyOAuth2

Scopes: 20 Flows: authorizationCode Method: derived

OAuth endpoints

Authorization URL
https://www.etsy.com/oauth/connect

Token URL
https://openapi.etsy.com/v3/public/oauth/token

Flows
authorizationCode

Scopes (20)

Scope	Description	Flows
address_r	see billing and shipping addresses	authorizationCode
address_w	update billing and shipping addresses	authorizationCode
billing_r	see all billing statement data	authorizationCode
cart_r	read shopping carts	authorizationCode
cart_w	add/remove from shopping carts	authorizationCode
email_r	read a user profile	authorizationCode
favorites_r	see private favorites	authorizationCode
favorites_w	add/remove favorites	authorizationCode
feedback_r	see purchase info in feedback	authorizationCode
listings_d	delete listings	authorizationCode
listings_r	see all listings (including expired etc)	authorizationCode
listings_w	create/edit listings	authorizationCode
profile_r	see all profile data	authorizationCode
profile_w	update user profile, avatar, etc	authorizationCode
recommend_r	see recommended listings	authorizationCode
recommend_w	accept/reject recommended listings	authorizationCode
shops_r	see private shop info	authorizationCode
shops_w	update shop	authorizationCode
transactions_r	see all checkout/payment data	authorizationCode
transactions_w	update receipts	authorizationCode

📄 Provider scope reference:

Source

OAuth Scopes

generated: '2026-07-11'
method: derived
source: openapi/etsy-openapi-original.yml
schemes:
- name: oauth2
  source: openapi/etsy-openapi-original.yml
  flows:
  - flow: authorizationCode
    authorizationUrl: https://www.etsy.com/oauth/connect
    tokenUrl: https://openapi.etsy.com/v3/public/oauth/token
  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).
scopes:
- scope: address_r
  description: see billing and shipping addresses
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: address_w
  description: update billing and shipping addresses
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: billing_r
  description: see all billing statement data
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: cart_r
  description: read shopping carts
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: cart_w
  description: add/remove from shopping carts
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: email_r
  description: read a user profile
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: favorites_r
  description: see private favorites
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: favorites_w
  description: add/remove favorites
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: feedback_r
  description: see purchase info in feedback
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: listings_d
  description: delete listings
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: listings_r
  description: see all listings (including expired etc)
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: listings_w
  description: create/edit listings
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: profile_r
  description: see all profile data
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: profile_w
  description: update user profile, avatar, etc
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: recommend_r
  description: see recommended listings
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: recommend_w
  description: accept/reject recommended listings
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: shops_r
  description: see private shop info
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: shops_w
  description: update shop
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: transactions_r
  description: see all checkout/payment data
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml
- scope: transactions_w
  description: update receipts
  flows:
  - authorizationCode
  sources:
  - openapi/etsy-openapi-original.yml