Private member workspace
Create an email-and-password account. Drafts, images, profiles and shop authorization are scoped to that member.
PRODUCT / V1
Tools for working with your own listings.
A private member workspace for product media, reusable listing preparation, authorized shop reads and explicitly confirmed draft creation.
ONE SELLER / ONE AUTHORIZED SHOP
The workspace connects product details, images and inventory without replacing Etsy.
The seller supplies or reviews the listing content. The application keeps the selected shop, listing state and requested operation visible as the task moves from preparation to confirmation.
- Input
- Seller-entered product information and seller-selected images
- Destination
- The Etsy shop authorized by that seller through OAuth
- Output
- A reported result for the defined listing task
View own listings
Read listings belonging to the shop authorized by the seller, including non-public listing information when permitted.
Prepare local drafts
Enter product information and save listing work locally without contacting Etsy.
Manage product images
Upload seller-provided JPEG, PNG or WebP files and select up to ten images for a draft.
Compose a mockup
Place a design image over a seller-selected product photograph, adjust its position and save the reviewed result to the image library.
Reuse listing profiles
Save a local draft as a reusable profile and create a separate new draft from it without changing Etsy.
Manage basic inventory
Set price, quantity, SKU and the standard inventory offering for the prepared draft.
Review one defined task
See the destination shop, requested scope and proposed operation before confirming any write request.
Use shop configuration
Read the shop's existing shipping and processing profiles required by a physical listing.
Report the result
Show whether the confirmed Etsy API task succeeded, failed or needs correction.
API capability map
Endpoint names describe the implemented technical route. The application follows the current Etsy Open API reference and requests only the scope required by each operation.
| Capability | Endpoint group | Access basis |
|---|---|---|
| Listing read | getListingsByShop | listings_r for the seller's active and non-public draft listing data |
| Create draft | createDraftListing | listings_w |
| Images | uploadListingImage | listings_w |
| Inventory | updateListingInventory | listings_w |
| Shop configuration | getShopShippingProfiles, getShopReadinessStateDefinitions | shops_r |
How a confirmed task is executed
A single seller-confirmed listing task may require more than one Etsy API call. For example, creating a draft, uploading images and applying inventory can be separate calls. The application limits those related calls to the task the seller reviewed and reports the combined result.
Explicitly outside V1
These boundaries keep the product description consistent with the current product and Etsy access request.
- No Etsy marketplace, checkout or buyer messaging
- No listing deletion or shop-setting writes
- No scheduled or unattended listing writes
- No bulk changes across multiple listings
- No existing-listing edit flow in V1
- No personalization-management flow in V1
- No continuous cross-marketplace synchronization
- No scripted browsing or Etsy page scraping
- No Etsy-data profiling or unrelated data-product development