Alpomera Listing Desk

Etsy connection

How we connect to your shop

Alpomera Listing Desk connects to Etsy only through Etsy's Open API v3 and Etsy's OAuth 2.0 consent flow. You grant or deny access on Etsy's own website, and you can withdraw it at any time.

Permissions we request

Etsy scopeWhy it is neededUsed by
shops_rTo identify the shop you connect (your Etsy user ID, shop ID and shop name) and to read your existing shipping profiles and processing profiles so you can pick them when preparing a draft for a physical item.Connect your shop, Prepare a draft listing
listings_rTo show your own listings in every state, including drafts and inactive listings that are not public, and to load the current text of a listing before you edit it.View listings, Edit listing text, Add an image
listings_wTo create a draft listing, to save changes to the title, description, tags and materials of your listing, and to add an image you upload to your listing. Used only after you confirm each change.Prepare a draft listing, Edit listing text, Add an image

Permissions we do not request

We do not request listings_d (deleting listings), shops_w (changing shop settings), transactions_r or transactions_w (orders and receipts), address_r or address_w (addresses), email_r (email addresses), or profile_r or profile_w (member profiles). The application cannot see your orders, your buyers, their addresses or their email addresses.

Your consent on Etsy

  • When you press Connect with Etsy, you are sent to Etsy's own page, where Etsy shows the permissions above and asks you to allow or deny them.
  • We use the OAuth 2.0 authorisation code flow with PKCE (S256) and a one-time, short-lived state value tied to your account. The callback address registered with Etsy is https://alpomera.com/oauth/callback.
  • We never ask for, see or store your Etsy password, and we never ask you for Etsy API keys.
  • One Alpomera Listing Desk account connects one Etsy shop, and a shop can be connected to only one account.

Access tokens and refresh

After you approve, Etsy gives the application an access token (valid for about one hour) and a refresh token. Both are stored encrypted on our server and are never sent to your browser. When the access token expires, our server asks Etsy for a new one using the refresh token, so you don't have to reconnect every hour. If the refresh is refused (for example because you removed the app on Etsy), we delete the connection and ask you to connect again.

How to disconnect

  • In Alpomera Listing Desk: open your workspace and choose Disconnect this shop. The stored tokens are deleted immediately. Deleting your account on the Account page also removes the connection.
  • On Etsy: you can also review and remove apps you have authorised in your Etsy account settings. After that, our refresh requests fail and the connection is deleted on our side.

The term 'Etsy' is a trademark of Etsy, Inc. This Application uses Etsy's API, but is not endorsed or certified by Etsy.