Scopes
Each API key holds a set of scopes; each operation in the reference lists the scopes it needs (x-lv-scopes). A key can never hold both etsy_drafts:write and catalog:live_write — a drafting key can't publish, and a publishing key can't write listing content. Keep each key in its own app or chat.
| Group | Scope | Label | What it allows | Lowest plan | Can't be combined with | Needs |
|---|---|---|---|---|---|---|
| Changes on Etsy | etsy_drafts:write | Create Etsy drafts | Create draft listings in your Etsy shops without asking you first, up to your plan's daily limit per shop, and delete Etsy drafts that ListingView created (never live listings). Shoppers can't see drafts. Can't be combined with 'Publish to Etsy'. | Plus | catalog:live_write | — |
| Changes on Etsy | catalog:live_write | Publish to Etsy | Push changes to, publish, or create-and-publish one listing at a time, or reprice up to 20 live print-on-demand listings at once, in your live shop. Each change needs a confirm step: apps like Claude ask you, but scripts can confirm on their own. Can't be combined with 'Create Etsy drafts'. | Plus | etsy_drafts:write | — |
| Changes on Etsy (Advanced) | confirm:auto | Skip publish confirmations | Lets the agent publish without asking you. Highest risk; only for agents you fully trust. | Plus | — | catalog:live_write |
| Changes in ListingView | catalog:write | Edit listings in ListingView | Create and edit listings in ListingView and get AI copy suggestions (uses AI tokens). Nothing reaches Etsy. | Scout | — | — |
| Changes in ListingView | assets:write | Upload and organize files | Upload PNG, JPEG or WebP files, import images from links, and organize collections, names and tags. Can't delete files or download originals. | Scout | — | — |
| Changes in ListingView | presets:write | Create and edit presets | Create, edit, copy (including to your other shops) and delete presets. Never changes listings. | Scout | — | — |
| Read only | research:read | Research Etsy | Search listings, shops, keywords and tags, and see your shop's stats. | Scout | — | — |
| Read only | catalog:read | See your listings and files | Read your ListingView listings, jobs and asset library. | Scout | — | — |
| Read only | presets:read | See your presets | Read preset names, defaults and design slots. | Scout | — | — |
Presets
Ready-made scope sets offered when you create a key in ListingView → Settings → API Keys. None of them includes confirm:auto.
| Preset | Scopes |
|---|---|
| Research Assistant | research:read |
| Catalog Editor | research:read catalog:read catalog:write assets:write |
| Drafting Agent | research:read catalog:read catalog:write assets:write presets:read presets:write etsy_drafts:write |
| Publisher | catalog:read catalog:live_write |