Etsy permissions
Which Etsy API permissions does Shop Pilot request?
Shop Pilot asks Etsy for eight permissions. Each one is listed below with what it is used for. You can check the list against Etsy's own documentation.
You approve the connection on Etsy's own page. Shop Pilot never asks for or sees your Etsy password.
For the technical reader: it uses Etsy's OAuth 2.0 sign-in with PKCE, over HTTPS.
| Permission | What Shop Pilot uses it for |
|---|---|
Read listingslistings_r | Read listing details and status for previews, editing, duplicate protection, draft review, registry history, and analytics. |
Create and edit listingslistings_w | Create and update listings, upload seller-authorized images and digital files, and publish when you explicitly request it. |
Delete listingslistings_d | Delete a listing you chose, after you confirm the deletion. |
Read shop detailsshops_r | Read basic information about the connected shop, sections, and identity so actions target the intended seller shop. |
Copy shop settingsshops_w | Create shop settings you explicitly ask for: copying shipping profiles, return policies, processing profiles and sections from one shop you have connected into another, so a newly opened shop does not have to be set up by hand. Used only on a shop you select, after you confirm exactly what will be created, and never to change or delete a setting that is already there. |
Read orderstransactions_r | Read paid orders for your analytics and, when you use Auto Orders, the order and delivery details it needs. |
Read delivery addressesaddress_r | Read the delivery address on a paid order, only to send an order you asked Shop Pilot to send. |
Add tracking numberstransactions_w | Add a shipment tracking number to a paid order in your own shop, so the buyer is notified, or mark the order shipped when Etsy does not accept the number, and only for an order you sent through Shop Pilot. It is never used to change an order's price or contents. |
Why does a listing tool need write access?
Creating a listing is a write operation, so a tool that creates listings cannot work with read-only access. listings_w is what lets Shop Pilot create the draft. Nothing is published until you ask for it.
What permissions does Shop Pilot not request?
Shop Pilot never asks to use carts or favorites, or to change billing or payments. It never collects your Etsy password and never handles buyer payments.
How is a shop connected and disconnected?
- You read these permissions and accept the Terms and Privacy Policy.
- Etsy shows you its permission page and you approve.
- Shop Pilot saves the access Etsy gives it, for your account and that shop only.
- You can disconnect in Account & Privacy. That deletes Shop Pilot's saved Etsy access and stops all calls to Etsy.
- You can also remove Shop Pilot in your Etsy account settings.