ConnectMyShop

Saved translations of one listing’s title, description and tags per language (de, en, es, fr, it, ja, nl, pl, pt). Languages without a saved translation use Etsy’s automatic translation.

get_listing_translations

The video on one listing (Etsy allows one), with its state and preview links.

get_listing_videos

Lifetime views and favourites of up to 300 active listings, with units sold in the last N days when this AI may read orders, and a “views but no sales” list to prioritise. Etsy has no views per period or search volume; say so rather than guessing.

get_listing_stats

One order: items with variations, totals, ship-by date, shipments with carrier and tracking, gift / buyer-message flags (the owner reads the text on Etsy), refunds, and the payment with Etsy’s processing fee and any adjustments. No buyer names, addresses or contact details: never ask for or guess them.

get_order

Payments for orders (by order ID) or by payment ID: gross, Etsy card-processing fee, net, and any refunds or other adjustments with reason and amounts. No buyer details.

get_payments

The shop’s processing profiles (Etsy readiness states: ready to ship or made to order, with processing days). readiness_state_id is what drafts and variants use.

get_processing_profiles

The shop’s return policies (returns, exchanges, deadline in days) with their IDs, optionally with how many listings use each.

get_return_policies

Carriers and mail classes Etsy supports from one origin country, for delivery-date estimates on shipping profiles and upgrades.

get_shipping_carriers

Full detail of the shop’s shipping profiles: origin, processing time, every destination with its cost and each-additional-item cost, delivery estimate, and shipping upgrades (e.g. express), with the IDs propose_shipping_profile_changes (if available) needs. Costs are in the shop currency.

get_shipping_profiles

Shop details plus shipping profiles, readiness (processing-time) states, production partners and return policies — the IDs needed when drafting listings.

get_shop

Buyer reviews of the shop or of one listing, newest first, with an average rating and star distribution. Filter by date, rating (e.g. maxRating 3 for critical reviews) or reviews with text. Reviews are public on Etsy; reviewer names are not included.

get_shop_reviews

Variants, prices, stock and SKUs for up to 100 listings in ONE request — use this instead of calling get_listing_inventory listing by listing (far fewer Etsy requests). Filter with where (e.g. "20 oz") to find every listing and variant with that option; detail: true lists every variant. Page with offset.

get_shop_inventory

Which listing photo each variation option (e.g. each colour) shows, plus the option IDs propose_variation_images (if available) needs.

get_variation_images

List the shop’s listings (title, state, price, tags, views, link). Use offset to page through.

list_listings

Recent orders: items, totals, dates, ship-by date, payment and shipping status, whether it is a gift, has a gift message or buyer note (the text itself stays on Etsy), and refunded amounts. to_ship: true lists what needs shipping now, soonest ship-by first, with late orders flagged. Buyer names, addresses and contact details are never included.

list_orders

Entries in the shop’s Etsy payment account for a period: sales, each Etsy fee, refunds, deposits to the bank, with running balance. Any period (default the last 30 days), as far back as today’s Etsy request allowance permits: Etsy serves 31 days at a time, so each month costs about one request. If the allowance runs short, the newest part is read and covered_from/covered_to/complete say exactly which dates are included. Newest month first; page with offset.

list_ledger_entries

Take one or multiple active listings off sale, without deleting them, in ONE approval. Use listingIds for both single and bulk requests. Requires owner approval unless deactivation auto-approval is enabled. To put listings back on sale later, use propose_reactivate_listing if available (needs publishing permission; Etsy fees may apply).

propose_deactivate_listing

Prepare edits (titles, tags, descriptions, materials, category, shipping profile, return policy, shop section, auto-renew and the other listing settings) to multiple listings in one batch. Large batches prepare and execute in the background. The shop owner gets ONE approval covering all of them — always prefer this over separate propose_listing_update calls when changing more than one listing.

propose_bulk_listing_update

Prepare marking public holidays as working or closed days for order processing (closed days move ship-by dates), in ONE approval the owner approves on the preview card. Holiday IDs from get_holiday_preferences (if available).

propose_holiday_changes

Prepare setting category attributes (e.g. primary colour, occasion, material, size) on up to 10 listings in the same category, in one approval. Attributes help buyers find listings through Etsy filters. Nothing changes on Etsy until the shop owner approves the preview card. Get property and value IDs from get_category_attributes (if available) first.

propose_listing_attributes

Prepare changes to a listing’s title, description, tags, materials, category, shipping profile, return policy, shop section, who/when made, production partners, item size or auto-renew. Does NOT change Etsy: the shop owner approves it first. IDs come from get_shop; categories from search_categories (if available).

propose_listing_update

Prepare saving a translated title, description and tags for one listing in one language (de, en, es, fr, it, ja, nl, pl, pt), shown to buyers browsing Etsy in that language. Creates or replaces that language’s translation; nothing changes until the shop owner approves the preview card. Translate faithfully; keep tags ≤20 characters, max 13.

propose_listing_translation

Prepare adding, replacing or removing the video on one listing (Etsy allows one video, 5–15 seconds; this request takes up to 20 MB). Nothing changes on Etsy until the shop owner approves the preview card. Pass a public https link to an MP4/MOV file (video_url, preferred), in ChatGPT the attached video as `file`, or, only when no link is possible, in apps that can read the owner’s files `local_file` (base64; the whole request must stay under 30 MB). A new video replaces the current one.

propose_listing_video

Prepare marking up to 25 paid orders from the owner’s own Etsy shop as shipped, with tracking number and carrier when available, in ONE approval. Only use it when the owner asks. After the owner approves the preview card, Etsy records the shipment and emails each buyer; this can’t be undone. Find orders with list_orders (to_ship: true) if it is in your tool list. Ask the owner for the tracking numbers AND the carrier (never invent either). Tracking that looks like a placeholder (contains test/sample, repeated digits, or under 8 characters) is refused unless the owner explicitly confirms that exact number; then send unusualTrackingConfirmed: true and the card flags it.

propose_mark_shipped

Prepare a new listing saved as an unpublished draft after the shop owner approves it. Pass variations (e.g. Size and Colour, with optionPrices for sizes that cost more) to create the variants in the same approval. Physical listings need shippingProfileId + readinessStateId; if that shipping profile's type is "calculated", also the packaged weight and dimensions (itemWeight/itemWeightUnit/itemLength/itemWidth/itemHeight/itemDimensionsUnit) — ask the owner. whoMade "someone_else" needs productionPartnerIds. Get all IDs from get_shop first. Digital listings (type "download"): in ChatGPT, if the owner attached the download file in chat, pass it as `file` so draft and file are approved together; otherwise the result includes an upload link for the file.

propose_draft_listing

Prepare permanently deleting listings from the owner’s own Etsy shop (any state, up to 10 per request) in ONE approval. Nothing is deleted until the owner approves the preview card; after that it cannot be undone: photos, stats and favourites are lost. Only use it when the owner clearly asks to delete; if they may want a listing back, use propose_deactivate_listing instead. Deleting always needs the owner’s approval, even with automatic approval on.

propose_delete_listing

Prepare setting the personalization questions buyers answer at checkout (up to 5: typed text or file uploads such as photos), or turning personalization off. Replaces the listing’s current questions, which the preview shows. Nothing changes on Etsy until the shop owner approves the preview card. Write short, clear questions with an example in the instructions.

propose_listing_personalization

Prepare adding, removing or reordering photos, or editing their alt text, on one listing in one approval. Removed photos can’t be restored automatically. Nothing changes on Etsy until the shop owner approves the preview card. Add photos from (preferred first): in ChatGPT, an image the owner attached OR one you created in this chat, passed as the file object in `file` (one) or `files` (several), never as a sandbox:/mnt/data path or inline base64; a public https image link (image_url); or, only in apps that can read the owner’s computer and only when no link is possible, a local file (local_file, base64; the whole request must stay under 30 MB, so send big or many photos as links or over several requests). Up to 10 new photos per request, 20 per listing. rank 1 = main photo. Call get_listing_images (if available) first for photo IDs. Write alt text that plainly describes only what is visible in the photo (≤500 characters), without mentioning AI or that it is a test.

propose_listing_images

Prepare a price change across the variants of one or several listings in ONE approval — all variants, or only those matching a variation value (e.g. “2XL”). Modes: set an exact price, adjust by percent, or adjust by amount.

propose_price_update

Prepare creating, updating or deleting processing profiles (ready to ship or made to order, 1–10 days or weeks), in ONE approval. Updated times change ship-by dates for every listing and variant using them once the owner approves the preview card. IDs from get_processing_profiles (if available).

propose_processing_profile_changes

Prepare publishing one draft listing (a listing that was never live) in the owner’s own Etsy shop. After the shop owner approves it, the listing becomes publicly visible and available for buyers to purchase on Etsy, and Etsy charges the seller its listing fee ($0.20 USD) on the seller’s Etsy bill. Only use it when the owner asks to publish. Nothing is published until the owner approves (automatic approval for publishing is off by default and only the owner can turn it on). The owner can take it off sale again with propose_deactivate_listing. For listings that were live before and are now inactive or expired, use propose_reactivate_listing (if available).

propose_publish_listing

Put inactive or expired listings from the owner’s own Etsy shop back on sale, in ONE approval (up to 10 per request). After the shop owner approves, the listings become publicly visible and purchasable on Etsy again; expired listings are renewed and Etsy charges the seller $0.20 USD each on the seller’s Etsy bill (the preview shows this fee). Only use it when the owner asks to reactivate or renew. Nothing changes until the owner approves (automatic approval for publishing and reactivation is off by default and only the owner can turn it on). The owner can take them off sale again with propose_deactivate_listing. Not for drafts (use propose_publish_listing, if available) or sold-out listings (add stock instead).

propose_reactivate_listing

Prepare creating, updating or deleting return policies (accepts returns, accepts exchanges, deadline 7–90 days), or consolidating one policy into another (moves its listings, then deletes it), in ONE approval. Buyers see new terms on every listing that uses the policy once the owner approves the preview card. IDs from get_return_policies (if available).

propose_return_policy_changes

Prepare changes to the shop’s shipping profiles in ONE approval: create profiles, rename or change origin/processing time, add/update/remove destinations (country or EU / non-EU region, cost and each-additional-item cost, delivery estimate), add/update/remove shipping upgrades, or delete profiles. Prices apply to every listing using the profile once the owner approves the before → after preview; nothing changes before that. Get IDs from get_shipping_profiles and carriers from get_shipping_carriers (if available). Ask the owner for prices; never invent them.

propose_shipping_profile_changes

Change shop-level settings on the owner’s public Etsy shop in ONE approval: shop title, announcement, the message buyers get after a purchase (and after a digital purchase), and shop sections (add, rename, remove). New text overwrites the current text, and an empty string clears it. Removing a section deletes that section (its listings stay in the shop, without a section) and cannot be undone automatically. Nothing changes until the shop owner reviews the before → after preview and approves it. Get section IDs from get_shop. To move a listing into a section use propose_listing_update with shopSectionId. Applied text changes can be restored with propose_revert_action; section changes cannot.

propose_shop_update

Prepare stock changes, turning variants on/off, or setting a SKU across one or many listings in ONE approval — all variants, or those matching where (e.g. "2XL", "Red"). quantity sets stock (0 = mark sold out), quantityChange adds or subtracts. Prices are not touched (use propose_price_update). Nothing changes on Etsy until the shop owner approves the preview card. Find listings and exact option names with get_shop_inventory (if available) first.

propose_inventory_update

Undo a finished change, with a new approval. Listing edits: restores the saved before-values. Price changes: restores every variant to its exact earlier price (for changes made after exact price backups were introduced). Deactivation: reactivates the listings (needs publishing permission; Etsy fee warning shown). Photo changes: puts back the earlier alt text and photo order exactly and removes photos the change added (not for changes that deleted photos, and refused if the photos changed since). Publishing and new drafts cannot be reverted — the tool explains the right alternative. Never overwrites newer changes. For changes that touched more than 10 listings, pass up to 10 listingIds at a time.

propose_revert_action

Prepare renaming variation options (e.g. sizes “S” → “Small”, or “Heather Grey” → “Sport Grey”) across one or several listings in ONE approval. Only the option names change; prices, stock, SKUs and enabled variants are kept. Nothing changes on Etsy until the shop owner approves the preview card. Use get_listing_inventory first for the exact current names. Pass variation (e.g. “Size”) to limit renames to one variation. Set partial: true to replace text inside option names (e.g. “T-Shirt” → “Tee” in “Gildan 5000 T-Shirt - S”).

propose_variation_rename

Prepare which listing photo each option of one variation shows (e.g. the red photo for Colour: Red). Replaces the listing’s current set; nothing changes until the shop owner approves the preview card. Get option IDs from get_variation_images and photo IDs from get_listing_images (if available).

propose_variation_images

Prepare adding variations to a listing, or replacing its current ones: up to 2 (e.g. Size × Colour, max 400 combinations), a base price and stock, prices per option (e.g. 2XL +$2 via optionPrices), and exceptions per combination (combos: price, stock, SKU or off). Replacing overwrites the current variants, which the preview shows. Nothing changes on Etsy until the shop owner approves the preview card. For a NEW listing, pass variations to propose_draft_listing instead. To change prices or stock of existing variants, use propose_price_update / propose_inventory_update (if available).

propose_listing_variations