add_digital_files_to_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Attach seller-approved downloadable files to an existing Etsy listing identified by its MakeBox listing_id. Requires confirm:true and one to five HTTPS file URLs; get_upload_link can provide a URL for a local file. Each file is downloaded and sent separately, with a 20 MB file limit and Etsy's five-file total limit. The response reports uploaded files and per-file failures; partial uploads may occur. It does not stage files locally or publish a draft. Read list_digital_files after the request to confirm the current files; do not repeat an uncertain upload automatically.
add_photos_to_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Attach the seller's own product photos to an existing listing, up to 20 at a time (Etsy's own limit per listing). ALWAYS PREFER https URLs: the photo is then downloaded server-side, so full-size originals of any weight work fine. A data: URI has to travel through this conversation as base64 text, which is impractical above roughly half a megabyte — if the only thing you have is a large local file, ask the seller to upload it in MakeBox or give you a link rather than inlining it. Photos are added after the existing ones; use set_main_photo or reorder_photos to change the order. They go to the LIVE Etsy listing in the same call, so confirm with the seller first — pass publish: false to stage them in MakeBox instead.
analyze_competitor_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read a public competitor listing and its color/attribute properties without connecting an Etsy shop. Primary/secondary colors are attributes, not confirmed selectable options. Missing data stays unknown. Pass requested_details only for the current user's task: colors, attributes, variations (including selectable colors/sizes), variant_prices. When browser_verification.status is required, use an available client browser to verify only the missing requested fields at its canonical Etsy URL; record source, time, exact choices and displayed price/currency. For older schemas without requested_details, user_request_check means select only missing_api_details relevant to the current user request. A returned plan is not a completed browser check. If no browser is available or access is blocked, say which fields remain unverified. Full inventory may use the caller's existing authorized Etsy connection, never another seller's token. No purchase or cart action. Do not copy competitor content or infer exact option prices from the headline price.
analyze_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Full report on a public Etsy shop — sales, reviews, favourites, how many listings it runs, its best-performing items and the tags it leans on. Works on the seller's own shop and on anybody else's. Accepts a shop name, a shop id or an Etsy URL. Counts against the daily lookup allowance on the free plan.
browse_categories
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Step through Etsy's category tree one level at a time, the way a seller does it in Shop Manager: call it with no parent to see the top-level departments, then call it again with the id of the one you want to see what is inside, and keep going until you reach a category with no children. Prefer this over search_categories when the product does not have an obvious single name — word search can rank a wrong branch first, while walking the tree cannot put you somewhere you did not choose.
bulk_edit_listings
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Apply a single mechanical change to a set of listings: price, tags, materials, shop section, auto-renew, or the buyer-facing colour/occasion/holiday attributes. Free — no AI, no credits (to rewrite copy use quote_bulk_seo instead). The change is saved in MakeBox; pass push: true to send the edited listings to Etsy in the same call, otherwise nothing on Etsy changes yet. Confirm the exact listings and the new value with the seller before calling — this is the tool that can reprice a whole shop.
check_keywords
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Look up an exact list of terms you already have in mind — your own tag ideas, phrases from the product, words a competitor uses — and get the real numbers for each. NEVER recommend a term containing someone else's brand or trademark (a company, a character, a franchise, or a phrase like 'dupe'/'inspired by' attached to one): those terms look like easy openings precisely BECAUSE competition is low, and the low competition is Etsy removing the listings. Using one gets the listing taken down and the shop struck. This is how you test a hypothesis instead of guessing: draft 13 candidate tags, check them here, and keep the ones the data supports. Terms come back in two groups: the ones we have statistics for, and the ones we do not. Missing statistics say nothing about Etsy — our database is incomplete, so a relevant term is still worth using.
clone_listing_as_new
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Clone an existing listing into a new MakeBox draft, preserving its photos, price, variations, personalization and category while using MakeBox AI to prepare new title, description and tags. Use only when the seller wants a new listing and approves an AI rewrite; create_listing accepts seller-written copy without rewriting it. The source remains unchanged. A new Etsy listing will receive a new URL when published, but no ranking improvement is guaranteed. Uses one listing action.
competitor_tags
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read the tags off the listings currently ranking for a phrase on Etsy and count which ones they share — the real vocabulary of that niche, taken from live listings rather than from our keyword database. Pass a listing_id as well and it also says which of those tags that listing is MISSING and which of its tags nobody else uses, which is the fastest way to find what to change. Public Etsy data; the shops involved do not need to be connected. Costs nothing.
create_listing
ChatGPTAVAILABLE for this account; upstream limitations and tool requirements still apply. Create an Etsy draft from the seller-approved title, description, tags, price, quantity, category and provenance supplied in this call. Requires confirm:true. MakeBox stores a local listing and sends the supplied content without AI rewriting. publish defaults to false; true additionally attempts activation after media upload and requires seller approval of that publication. Photos, videos and digital files may be supplied as seller-owned URLs. Optional media or translation failures are returned under problems after the Etsy draft exists. Read the returned Etsy listing back before claiming its final state; never automatically repeat an uncertain creation. get_upload_link supports approved local files.
create_processing_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Create a processing profile — how many days the seller needs before an order goes out, and whether items are ready to ship or made to order. Etsy requires one on physical listings. If an identical profile already exists Etsy says so, which is fine: the outcome the seller wanted is already true.
create_return_policy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Create a return policy on the shop. Etsy needs two answers — does the seller accept returns, and does the seller accept exchanges — and a deadline in days if either is yes. ASK THE SELLER; never guess these. A return policy is a promise to buyers and a legal commitment, and the wrong one costs them money. Etsy allows deadlines of 7, 14, 21, 30, 45, 60 or 90 days. A brand-new shop usually has none, so this is part of setting one up.
create_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Make a fixed-price shipping profile on Etsy. This matters for a shop that has just connected: Etsy requires a shipping profile on every physical listing, so without one nothing can be published at all. Ask the seller for the real numbers — where they ship from, what postage costs them — and never invent them. Calculated (weight-based) profiles cannot be created through Etsy's API; those have to be made in Shop Manager.
delete_assets
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Permanently remove items from the Asset Library. There is no undo — read the titles back to the seller and get a clear yes before calling this.
delete_photo
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Remove a photo from a listing in MakeBox. The file is deleted too, so this cannot be undone from the chat — confirm with the seller which photo they mean before calling it.
edit_listing_tags
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Add tags to a listing, or take specific ones off, keeping the rest as they are. Use this for 'add christmas to that listing' or 'drop the vintage tag' — update_listing replaces the whole set, which loses everything not repeated. Etsy allows 13 tags; adding past that is refused rather than silently truncated. Saves in MakeBox; push_listing_to_etsy sends it on.
etsy_consolidate_shop_return_policies
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Consolidates Return Policies by moving all listings from a source return policy to a destination return policy, and deleting the source return policy. This is commonly used in the event that a user attempts to update a Return Policy such that its data is a duplicate of some other Return Policy, which is prevented. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/consolidateShopReturnPolicies
etsy_create_draft_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a physical draft [listing](/documentation/reference#tag/ShopListing) product in a shop on the Etsy channel. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createDraftListing
etsy_create_listing_translation
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a ListingTranslation by listing_id and language Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createListingTranslation
etsy_create_receipt_shipment
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Submits tracking information for a Shop Receipt, which creates a Shop Receipt Shipment entry for the given receipt_id. Each time you successfully submit tracking info, Etsy sends a notification email to the buyer User. When send_bcc is true, Etsy sends shipping notifications to the seller as well. When tracking_code and carrier_name aren't sent, the receipt is marked as shipped only. If the carrier is not supported, you may use other as the carrier name so you can provide the tracking code. NOTES When shipping within the United States AND the order is over $10 _or_ when shipping to India, tracking code and carrier name ARE required. Access to ShopReceipt's first_line, second_line, city, state, zip, country_iso and formatted_address is contingent in some regions to a preferred partnership status with Etsy Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createReceiptShipment
etsy_create_shop_readiness_state_definition
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a new ReadinessStateDefinition. If an existing definition matches the input values, this endpoint will throw a Conflict error, please refer to the Content-Location header to obtain the get endpoint url for the values of the existing definition. Does not affect the product offering-readiness states definition relationship. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createShopReadinessStateDefinition
etsy_create_shop_return_policy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a new Return Policy. Note: if either accepts_returns or accepts_exchanges is true, then a return_deadline is required. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createShopReturnPolicy
etsy_create_shop_section
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a new section in a specific shop. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createShopSection
etsy_create_shop_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a new ShippingProfile. You can pass a country iso code or a region when creating a ShippingProfile, but not both. Only one is required. You must pass either a shipping_carrier_id AND mail_class, or both min and max_delivery_days. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createShopShippingProfile
etsy_create_shop_shipping_profile_destination
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a new shipping destination, which sets the shipping cost, carrier, and class for a destination in a [shipping profile](/documentation/reference/#tag/Shop-ShippingProfile). createShopShippingProfileDestination assigns costs using the currency of the associated shop. Set the destination using either destination_country_iso or destination_region; destination_country_iso and destination_region are mutually exclusive — set one or the other. Setting both triggers error 400. If the request sets neither destination_country_iso nor destination_region, the default destination is "everywhere". You must also either assign both a shipping_carrier_id AND mail_class or both min_delivery_days AND max_delivery_days. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createShopShippingProfileDestination
etsy_create_shop_shipping_profile_upgrade
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates a new shipping profile upgrade, which can establish a price for a shipping option, such as an alternate carrier or faster delivery. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/createShopShippingProfileUpgrade
etsy_delete_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint to delete a ShopListing. A ShopListing can be deleted only if the state is one of the following: SOLD_OUT, DRAFT, EXPIRED, INACTIVE, ACTIVE and is_available or ACTIVE and has seller flags: SUPRESSED (frozen), VACATION, CUSTOM_SHOPS (pattern), SELL_ON_FACEBOOK Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteListing
etsy_delete_listing_file
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes a file from a specific listing. When you delete the final file for a digital listing, the listing converts into a physical listing. The response to a delete request returns a list of the remaining file records associated with the given listing. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteListingFile
etsy_delete_listing_image
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint to delete a listing image. A copy of the file remains on our servers, and so a deleted image may be re-associated with the listing without re-uploading the original image; see uploadListingImage. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteListingImage
etsy_delete_listing_personalization
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes personalization for a listing. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteListingPersonalization
etsy_delete_listing_property
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes a property for a Listing. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteListingProperty
etsy_delete_listing_video
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint to delete a listing video. A copy of the video remains on our servers, and so a deleted video may be re-associated with the listing without re-uploading the original video; see uploadListingVideo. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteListingVideo
etsy_delete_shop_readiness_state_definition
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes a ReadinessStateDefinition by given readiness state definition ID. If there any active offerings linked to the definition, this endpoint will throw a Bad Request error. If you want to delete a ReadinessStateDefinition that is linked to active offerings, you must link the offerings to a different readiness state definition. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteShopReadinessStateDefinition
etsy_delete_shop_return_policy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes an existing Return Policy. Deletion is only allowed for policies which have no associated listings – move them to another policy before attempting deletion. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteShopReturnPolicy
etsy_delete_shop_section
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes a section in a specific shop given a valid shop_section_id. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteShopSection
etsy_delete_shop_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes a ShippingProfile by given id. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteShopShippingProfile
etsy_delete_shop_shipping_profile_destination
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes a shipping destination and removes the destination option from every listing that uses the associated shipping profile. A shipping profile requires at least one shipping destination, so this endpoint cannot delete the final shipping destination for any shipping profile. To delete the final shipping destination from a shipping profile, you must [delete the entire shipping profile](/documentation/reference/#operation/deleteShopShippingProfile). Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteShopShippingProfileDestination
etsy_delete_shop_shipping_profile_upgrade
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Deletes a shipping profile upgrade and removes the upgrade option from every listing that uses the associated shipping profile. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteShopShippingProfileUpgrade
etsy_delete_user_address
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint to delete a UserAddress for a User. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/deleteUserAddress
etsy_find_all_active_listings_by_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of all active listings on Etsy in a specific shop, paginated by listing creation date. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/findAllActiveListingsByShop
etsy_find_all_listings_active
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Search public active Etsy listings without connecting your own shop. For 200 results from one phrase, call with limit:100 and offset:0, then the same keywords/filters with offset:100. buyer_country:US filters listings that ship to the USA; shop_location is the seller location and is different. sort_on:score gives Etsy API relevance order, not a guaranteed personalized website position. Do not replace a requested single-query sample with several different phrases. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/findAllListingsActive
etsy_find_shops
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint for searching shops by name. Note: We make every effort to ensure that frozen or removed shops are not included in the search results. However, rarely, due to timing issues, they may appear. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/findShops
etsy_get_all_listing_files
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves all the files associated with the given digital listing. Requesting files from a physical listing returns an empty result. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getAllListingFiles
etsy_get_buyer_taxonomy_nodes
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the full hierarchy tree of buyer taxonomy nodes. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getBuyerTaxonomyNodes
etsy_get_featured_listings_by_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves Listings associated to a Shop that are featured. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getFeaturedListingsByShop
etsy_get_holiday_preferences
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of holidays that are available to a shop to set a preference for. Currently only supported in the US and CA Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getHolidayPreferences
etsy_get_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a listing record by listing ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListing
etsy_get_listing_file
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a single file associated with the given digital listing. Requesting a file from a physical listing returns an empty result. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingFile
etsy_get_listing_image
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the references and metadata for a listing image with a specific image ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingImage
etsy_get_listing_images
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves all listing image resources for a listing with a specific listing ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingImages
etsy_get_listing_inventory
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the inventory record for a listing. Listings you did not edit using the Etsy.com inventory tools have no inventory records. This endpoint returns SKU data if you are the owner of the inventory records being fetched. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingInventory
etsy_get_listing_offering
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Get an Offering for a Listing Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingOffering
etsy_get_listing_personalization
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a listing's personalization questions by listing ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingPersonalization
etsy_get_listing_product
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint to retrieve a ListingProduct by ID. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingProduct
etsy_get_listing_properties
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read public listing attributes, including primary/secondary colors when the seller supplied them, with the app key only; no Etsy shop connection is required. Use the listing’s public shop_id, not the researcher’s workspace id. Empty or omitted colors are unknown; property values do not establish selectable variations or combination prices. For user-requested missing option details, use analyze_competitor_listing with requested_details and follow its conditional client-browser verification contract. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingProperties
etsy_get_listing_property
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Call Etsy's getListingProperty endpoint for a listing and property id. Etsy documents this endpoint as under development and returning HTTP 501; it does not currently provide property data. Use etsy_get_listing_properties to read the available property list instead. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingProperty
etsy_get_listing_translation
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Get a Translation for a Listing in the given language Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingTranslation
etsy_get_listing_variation_images
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Gets all variation images on a listing. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingVariationImages
etsy_get_listing_video
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Call Etsy's single-video endpoint with a listing id and video id. Etsy documents that this request returns an empty result; do not rely on it to retrieve video content. Use etsy_get_listing_videos for the current video list. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingVideo
etsy_get_listing_videos
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves all listing video resources for a listing with a specific listing ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingVideos
etsy_get_listings_by_listing_ids
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Allows to query multiple listing ids at once. Limit 100 ids maximum per query. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingsByListingIds
etsy_get_listings_by_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Endpoint to list Listings that belong to a Shop. Listings can be filtered using the 'state' param. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingsByShop
etsy_get_listings_by_shop_receipt
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Gets all listings associated with a receipt. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingsByShopReceipt
etsy_get_listings_by_shop_return_policy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Gets all listings associated with a Return Policy. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingsByShopReturnPolicy
etsy_get_listings_by_shop_section_id
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves all the listings from the section of a specific shop. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingsByShopSectionId
etsy_get_listings_inventory_by_listing_ids
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the inventory record for each listing referenced by listing ID. Requires the listings_r OAuth scope. Limit 100 listing IDs per request. All requested listing IDs must exist — if any single ID is not found, the entire request returns a 404. SKUs within product records are only returned for listings owned by the authenticated user; they are stripped (returned as empty string) for listings owned by other sellers. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingsInventoryByListingIds
etsy_get_listings_shipping_by_listing_ids
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the shipping profile for each listing referenced by listing ID. Requires the shops_r OAuth scope. Limit 100 listing IDs per request. All requested listing IDs must exist — if any single ID is not found, the entire request returns a 404. Shipping profile data (including shipping_profile_id) is only returned for listings owned by the authenticated user; it is nulled out for listings owned by other sellers. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getListingsShippingByListingIds
etsy_get_me
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Returns basic info for the user making the request. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getMe
etsy_get_payment_account_ledger_entry_payments
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Get a Payment from a PaymentAccount Ledger Entry ID, if applicable Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getPaymentAccountLedgerEntryPayments
etsy_get_payments
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of payments from a shop identified by shop_id. You can also filter results using a list of payment IDs. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getPayments
etsy_get_properties_by_buyer_taxonomy_id
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of product properties, with applicable scales and values, supported for a specific buyer taxonomy ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getPropertiesByBuyerTaxonomyId
etsy_get_properties_by_taxonomy_id
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of product properties, with applicable scales and values, supported for a specific seller taxonomy ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getPropertiesByTaxonomyId
etsy_get_reviews_by_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 to retrieve the reviews for a listing given its ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getReviewsByListing
etsy_get_reviews_by_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 to retrieve the reviews from a shop given its ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getReviewsByShop
etsy_get_seller_taxonomy_nodes
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the full hierarchy tree of seller taxonomy nodes. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getSellerTaxonomyNodes
etsy_get_shipping_carriers
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of available shipping carriers and the mail classes associated with them for a given country Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShippingCarriers
etsy_get_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the shop identified by a specific shop ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShop
etsy_get_shop_by_owner_user_id
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the shop identified by the shop owner's user ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopByOwnerUserId
etsy_get_shop_payment_account_ledger_entries
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Get a Shop Payment Account Ledger's Entries Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopPaymentAccountLedgerEntries
etsy_get_shop_payment_account_ledger_entry
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Get a single Shop Payment Account Ledger's Entry Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopPaymentAccountLedgerEntry
etsy_get_shop_payment_by_receipt_id
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a payment from a specific receipt, identified by receipt_id, from a specific shop, identified by shop_id Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopPaymentByReceiptId
etsy_get_shop_production_partners
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of production partners available in the specific Etsy shop identified by its shop ID. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopProductionPartners
etsy_get_shop_readiness_state_definition
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a ProcessingProfile referenced by readiness state definition ID. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReadinessStateDefinition
etsy_get_shop_readiness_state_definitions
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of ProcessingProfiles available in the specific Etsy shop identified by its shop ID. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReadinessStateDefinitions
etsy_get_shop_receipt
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a receipt, identified by a receipt id, from an Etsy shop. NOTE Access to ShopReceipt's first_line, second_line, city, state, zip, country_iso and formatted_address is contingent in some regions to a preferred partnership status with Etsy Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReceipt
etsy_get_shop_receipt_transaction
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a transaction by transaction ID. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReceiptTransaction
etsy_get_shop_receipt_transactions_by_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the list of transactions associated with a listing. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReceiptTransactionsByListing
etsy_get_shop_receipt_transactions_by_receipt
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the list of transactions associated with a specific receipt. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReceiptTransactionsByReceipt
etsy_get_shop_receipt_transactions_by_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the list of transactions associated with a shop. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReceiptTransactionsByShop
etsy_get_shop_receipts
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Requests the Shop Receipts from a specific Shop, unfiltered or filtered by receipt id range or offset, date, paid, and/or shipped purchases. NOTE Access to ShopReceipt's first_line, second_line, city, state, zip, country_iso and formatted_address is contingent in some regions to a preferred partnership status with Etsy Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReceipts
etsy_get_shop_return_policies
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Returns a shop's list of existing Return Policies Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReturnPolicies
etsy_get_shop_return_policy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves an existing Return Policy. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopReturnPolicy
etsy_get_shop_section
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a shop section, referenced by section ID and shop ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopSection
etsy_get_shop_sections
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the list of shop sections in a specific shop identified by shop ID. Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopSections
etsy_get_shop_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a Shipping Profile referenced by shipping profile ID. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopShippingProfile
etsy_get_shop_shipping_profile_destinations_by_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of shipping destination objects associated with a shipping profile. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopShippingProfileDestinationsByShippingProfile
etsy_get_shop_shipping_profile_upgrades
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves the list of shipping profile upgrades assigned to a specific shipping profile. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopShippingProfileUpgrades
etsy_get_shop_shipping_profiles
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a list of shipping profiles available in the specific Etsy shop identified by its shop ID. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getShopShippingProfiles
etsy_get_user
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Retrieves a user profile based on a unique user ID. Access is limited to profiles of the authenticated user or linked buyers. For the primary_email field, specific app-based permissions are required and granted case-by-case. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getUser
etsy_get_user_address
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint to retrieve a UserAddress for a User. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getUserAddress
etsy_get_user_addresses
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Open API V3 endpoint to retrieve UserAddresses for a User. Private calls use the connected seller's shop. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/getUserAddresses
etsy_ping
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Check to confirm connectivity to the Etsy API with an application Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/ping
etsy_token_scopes
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Check the scopes of the provided token Public research may specify a shop or listing from Etsy. Reads the current Etsy response. Official operation: https://developers.etsy.com/documentation/reference/#operation/tokenScopes
etsy_update_holiday_preferences
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates the preference for whether the seller will process orders or not on the holiday. Currently only supported in the US and CA Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateHolidayPreferences
etsy_update_listing
ChatGPTAVAILABLE for this account; upstream limitations and tool requirements still apply. Updates a listing, identified by a listing ID, for a specific shop identified by a shop ID. Note that this is a PATCH method type. When activating, or manually renewing a physical listing, the shipping profile referenced by the shipping_profile_id, and all of its fields, along with its entries and upgrades must be complete and valid. If the shipping profile is not complete and valid, we will throw an exception with an error message that guides the request sender to update whatever data is bad. Digital listings that are not made to order must have a file upload associated with it to be activated. While the listing is a draft, shipping profile and file upload are not required in any case. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateListing
etsy_update_listing_inventory
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates the inventory for a listing identified by a listing ID. The update fails if the supplied values for product sku, offering quantity, price, and/or processing profile are incompatible with values in *_on_property fields. When setting a price, assign a float equal to amount divided by divisor as specified in the Money resource. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateListingInventory
etsy_update_listing_personalization
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates or updates personalization settings for a listing, allowing the seller to collect personalization from the buyer. This endpoint will fully replace any existing personalization on the listing. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateListingPersonalization
etsy_update_listing_property
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates or populates the properties list defining product offerings for a listing. Each offering requires both a value and a value_id that are valid for a scale_id assigned to the listing or that you assign to the listing with this request. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateListingProperty
etsy_update_listing_translation
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates a ListingTranslation by listing_id and language Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateListingTranslation
etsy_update_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates a shop. Assumes that all string parameters are provided in the shop's primary language. Please note that the policy_additional field should only be set for shops located in the EU. Passing a value for this field for shops outside of the EU, will result in an error. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShop
etsy_update_shop_readiness_state_definition
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates an existing ReadinessStateDefinition. If an existing definition matches the input values, this endpoint will throw a Conflict error, please refer to the Content-Location header to obtain the get endpoint url for the values of the existing definition. Does not affect the product offering-readiness states definition relationship. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShopReadinessStateDefinition
etsy_update_shop_receipt
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates the status of a receipt, identified by a receipt id, from an Etsy shop. NOTE Access to ShopReceipt's first_line, second_line, city, state, zip, country_iso and formatted_address is contingent in some regions to a preferred partnership status with Etsy Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShopReceipt
etsy_update_shop_return_policy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates an existing Return Policy. Note: if either accepts_returns or accepts_exchanges is true, then a return_deadline is required. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShopReturnPolicy
etsy_update_shop_section
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates a section in a specific shop given a valid shop_section_id. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShopSection
etsy_update_shop_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Update the connected shop's shipping-profile title, origin country or postal code, and processing-time settings supplied in body. This operation does not update destination charges, delivery estimates or shipping upgrades; use the corresponding destination or upgrade tools for those fields. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShopShippingProfile
etsy_update_shop_shipping_profile_destination
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates an existing shipping destination, which can set or reassign the shipping cost, carrier, and class for a destination. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShopShippingProfileDestination
etsy_update_shop_shipping_profile_upgrade
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Updates a shipping profile upgrade and updates any listings that use the shipping profile. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateShopShippingProfileUpgrade
etsy_update_variation_images
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Creates variation images on a listing. variation_images is an array with inputs for the property_id, value_id, and image_id fields. image_ids are associated with a ListingImage on the listing associated with the provided listing_id. property_id and value_id pairs are associated with a ListingProduct on the listing associated with the provided listing_id. variation_images should not contain any duplicates. variation_images does not contain more than one property_id as variation images can only be associated on one property. The update overwrites all existing variation images on a listing, so if your request is successful, the variation images on the listing will be exactly those you specify. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/updateVariationImages
etsy_upload_listing_file
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Uploads a new file for a digital listing, or associates an existing file with a specific listing. You must either provide the listing_file_id of an existing file, or the name and binary file data for a file to upload. Associating an existing file to a physical listing converts the physical listing into a digital listing, which removes all shipping costs and any product and inventory variations. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/uploadListingFile
etsy_upload_listing_image
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Uploads or assigns an image to a listing identified by a shop ID with a listing ID. To upload a new image, set the image file as the value for the image parameter. You can assign a previously deleted image to a listing using the deleted image's image ID in the listing_image_id parameter. When a request contains both image and listing_image_id parameter values, the endpoint uploads the image in the image parameter only. Note: When uploading a new image, data such as colors and size may return as null values due to asynchronous processing of the image. Use getListingImage endpoint to fetch these values. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/uploadListingImage
etsy_upload_listing_video
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Uploads a new video for a listing, or associates an existing video with a specific listing. You must either provide the video_id of an existing video, or the name and binary file data for a video to upload. If providing a video_id, the video must already be associated with the same shop as the listing, but it does not need to be currently associated with the listing. By default, the endpoint handles single video uploads, but setting is_multi_video to true enables to link up to 2 videos to the same listing. Private calls use the connected seller's shop. Sends the approved values directly to Etsy without AI rewriting. After a successful response, read back the resource before claiming its final state. Never automatically repeat an uncertain write. Official operation: https://developers.etsy.com/documentation/reference/#operation/uploadListingVideo
find_shops_in_my_niche
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Find shops competing in the same niche as a given shop. It takes that shop's most-used tag, searches Etsy for it, and returns the shops behind those listings with their sales and review counts — the answer to 'who else sells this' and 'who are the big players in my niche'. Pass the seller's own shop id to see their competition; results are cached for a day.
fulfil_order
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Close out an order: add a tracking number, mark it shipped, or both. Adding tracking EMAILS THE BUYER, so read the order and the tracking number back to the seller and get a clear yes before calling. Get receipt ids from list_orders. Needs Etsy's order-management permission on the connection.
generate_alt_text
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Use AI to draft alt-text for each photo on a listing. Alt-text supports accessibility and gives Etsy more image context, but no search placement is guaranteed. This uses MakeBox AI allowance; show the cost before invoking it.
get_account_status
ChatGPTAlways available to check the current plan and access; call again after a plan change. How many ✨ credits the seller has left, which plan they are on, and what today's remaining allowance is for keyword searches, niche searches and photo scoring. Check this before starting anything expensive — a bulk SEO run over 50 listings, for example — so the user is not told halfway through that they ran out. Costs nothing.
get_bulk_seo_job
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Progress of a bulk SEO job: how far along it is, which stage each listing is at, and what failed. Poll this after start_bulk_seo rather than assuming the run finished.
get_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Fetch one listing in full, including its description and tags. Use the id returned by list_listings.
get_listing_offerings
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The price and quantity for each combination of a listing's variations — e.g. Size L in Black. For a listing that is on Etsy this reads LIVE FROM ETSY, so it sees prices set up in Etsy's own Shop Manager as well as ones made in MakeBox.
get_listing_personalization
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The personalization fields buyers fill in on this listing — Etsy's 'Custom options'. Read this before changing them: setting fields replaces the whole set.
get_listing_variations
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read the variation axes on a listing — e.g. Size with Small/Medium/Large, Colour with Black/White — together with the price and stock of every combination. For a listing that is on Etsy this reads LIVE FROM ETSY, so it also sees variations that were set up in Etsy's own Shop Manager and were never created through MakeBox. Use it before answering any question about what a listing's options cost.
get_niche_report
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read progress or a completed account-owned niche report, free. No Etsy shop required. Preserve evidence and uncertainty when summarizing; never equate favourites with sales.
get_order
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read one order directly from Etsy now: buyer, address, totals, shipping status and tracking, plus every line with the options chosen and the exact personalization typed. A saved MakeBox copy is never substituted. Costs nothing.
get_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read one of this shop's shipping profiles live from Etsy, including its destinations, primary and additional-item costs. Use this after list_shipping_profiles and before asking the seller to switch an existing listing's profile; the profile title alone does not tell them what buyers will pay. Costs nothing.
get_shop_stats
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read current orders from Etsy and calculate revenue, order count, units, average order value, the last 12 months, digital/physical split and top 10 products. Shop-section breakdown comes from the MakeBox sync and is marked separately. Use list_orders for individual orders. Costs nothing.
get_upload_link
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Create a single-use HTTPS upload link for a seller-owned local photo, design, digital download or listing video. The link lasts about 15 minutes. Images and digital files can be up to 20 MB; video can be up to 100 MB. Uploading a local file requires the seller's authorization and file access in the client. After upload, the returned download_url can be used in create_listing, add_photos_to_listing or add_digital_files_to_listing. The tool does not upload a file by itself and uses no MakeBox AI allowance.
list_assets
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. List what the seller has stored in their Asset Library — saved listing names, designs, mockups, uploaded files and links — with the folders they are filed under. Use it before saving something, so a near-duplicate is spotted, and to answer 'what do I have for X?'. Costs nothing.
list_changes
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Show the change history for a listing — what was edited, when, and the value before and after. Use it to answer 'what did you change?' and to find the change_id needed by revert_change.
list_competitor_listings
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Browse any Etsy shop's active listings — title, link, price, views, favourites and tags — and optionally only the ones inside one of that shop's own categories. Call it without a section to see the shop's categories listed back, then again naming the one you want. This is the tool for 'show me what they sell in their Signs section' and 'which of their listings gets the most views'. Public Etsy data; the shop does not need to be connected to MakeBox.
list_digital_files
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. What a buyer receives when they purchase this listing, straight from Etsy.
list_listing_videos
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The videos currently attached to a listing on Etsy, read live from Etsy rather than from MakeBox's copy. Call it before adding one: Etsy allows two per listing, so knowing what is already there is the difference between adding a second video and being refused. Costs nothing.
list_listings
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. List listings in the connected shop. Use it to find a listing before editing it, or to review what the shop currently sells. Returns id, title, status, price and tags — call get_listing for the full description. Reads the shop LIVE from Etsy — active, draft and inactive, as they are right now. Pass live:false only when you need MakeBox's own fields (photo scores, when a listing was last optimized) or a listing drafted in MakeBox that has never been pushed to Etsy.
list_monitored_shops
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The competitor shops this seller tracks, with the latest public stats MakeBox pulled for each and when they were last refreshed.
list_niche_reports
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. List the latest20 report jobs belonging to the signed-in account. Free; reopening does not spend credits.
list_orders
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Read orders directly from the connected Etsy shop on every call, newest first. Show what was bought, the shipping address, tracking, chosen options and the buyer's exact personalization. Never use a previously synced MakeBox copy as a current order. Only this shop's orders are visible.
list_photos
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The photos on a listing in the order buyers see them, with each one's alt-text and whether it is the hero image. Call this before reordering, deleting or setting a main photo — every other photo tool needs the photo_id from here.
list_production_partners
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. List the production partners registered on this Etsy shop — the outside makers Etsy requires a seller to declare when someone else helps produce an item. Read them before setting production partners on listings, so partners can be chosen by name rather than by an id nobody knows. Partners themselves can only be added in Etsy's Shop Manager. Costs nothing.
list_return_policies
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The return policies that exist on this Etsy shop, with their ids. A listing may carry one, and a shop that has never set one has none — which is why a brand-new shop needs create_return_policy before its listings can reference a policy at all. Read live from Etsy. Costs nothing.
list_sections
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. List the seller's own shop sections (their categories on Etsy) with how many listings sit in each. Call this when the user names a category so you can pass the exact section name to list_listings.
list_shipping_profiles
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The shipping profiles that exist on this Etsy shop right now, with their ids. Read this BEFORE creating a physical listing: Etsy requires a shipping_profile_id on every physical listing, and creating a second identical profile instead of reusing one leaves the seller with a cluttered shop. A digital listing needs none of this. Fetched live from Etsy on every call, never from a cached copy, so a profile the seller made in Shop Manager a minute ago is already here. Costs nothing.
list_shop_languages
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The languages this Etsy shop has actually enabled in Shop Manager → Languages. Read this BEFORE writing any translation: Etsy refuses a translation for a language the shop has not enrolled, and the attempt still costs the seller. Translate only into what comes back here; if the seller wants another language, they must add it in Shop Manager first. Read live from Etsy. Costs nothing.
list_shops
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. List the Etsy shops on this MakeBox account, and show which one this connection is currently working with. Call this first when the user mentions a shop by name, or when it is unclear which shop a request refers to.
list_watchlist
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Return the connected workspace's saved watchlist items and folders. Items include listing, shop, tag or keyword references, labels and stored metadata, ordered newest first and limited to 1000. Optional kind filters the items; the folder list is returned separately. Reads MakeBox storage and does not refresh Etsy or keyword statistics.
manage_listing_videos
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Put the seller's own videos on a live Etsy listing, swap them, or take them off. Etsy allows 2 videos per listing alongside its 20 photos. Pass https URLs to ADD them; pass replace: true to clear what is on the listing first (that is how you swap one video for another); pass replace: true with no videos to remove them all. The videos must be the seller's own — never source or generate one. THIS CHANGES WHAT BUYERS SEE, so confirm with the seller before calling. Photos are managed separately: add_photos_to_listing, delete_photo, reorder_photos, set_main_photo.
manage_shop_sections
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Shop sections are the seller's own categories on their storefront. Create one, rename one, or delete one. Pair it with bulk_edit_listings set_section to make 'put these ten into a new Christmas section' a single piece of work. Deleting a section does NOT delete its listings — they simply stop being in any section — but say that before deleting, and get a yes.
monitor_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Start tracking a competitor: MakeBox re-reads its public stats every day, so the seller can watch sales, reviews and listing count move over time. Use this when the user says 'keep an eye on this shop' or 'add it to monitoring'. The shop is looked up first, so pass whatever the user said — a name, an id or a URL.
optimize_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Rewrite selected listing fields using confirmed product facts and available keyword research. Returns a suggestion without saving or publishing it. Uses the same MakeBox allowance as the website and Chrome: all three fields cost one listing action; one field costs one third. Do not call speculatively or repeat a successful generation. After review, save with update_listing(publish: false); publish only with the seller's approval.
push_bulk_seo_job
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Push every listing in a finished bulk job to the live Etsy shop at once. THIS CHANGES WHAT BUYERS SEE across many listings and Etsy keeps no undo. Wait until the job is done, show the user what changed, and only call this when they have explicitly approved publishing all of it. Requires confirm: true.
push_listing_to_etsy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Push the saved listing to the live Etsy shop. THIS CHANGES WHAT BUYERS SEE and Etsy keeps no undo of its own. Only call it when the user has seen the exact changes and asked for them to go live — never to 'finish' a task on your own initiative. Requires confirm: true.
push_listing_variations
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Send the complete variation axes and prices/stock already saved in MakeBox to Etsy, then read Etsy inventory and compare every combination. Does not recreate or overwrite the saved MakeBox configuration. Requires confirm: true after seller approval. If sync_status is unconfirmed, read get_listing_variations before retrying; never repeat the write automatically. Only on_etsy: true with sync_status: verified confirms the saved inventory is on Etsy.
push_photos_to_etsy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Upload this listing's stored photos and videos to Etsy with their order and alt-text. Photos already sent are skipped, so calling it twice does not duplicate them. THIS CHANGES WHAT BUYERS SEE. Etsy allows 20 images and 2 videos per listing; if the set does not fit, nothing is uploaded rather than half of it — pass replace: true to clear the listing's Etsy photos first and make MakeBox's set the listing's set, which is also the way out when the two sides have drifted apart. Requires confirm: true.
quote_bulk_seo
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Work out exactly what a bulk SEO run would cost and whether the balance covers it, WITHOUT starting anything or spending a credit. Always call this first and tell the user the number — a fifty-listing run on a premium model is a real bill, and it must never be spent on their behalf without them hearing the price.
quote_translation
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. What translating a listing into given languages would cost, and whether the balance covers it. Costs nothing. Call it before translate_listing and tell the user the number.
remove_from_watchlist
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Take an item off the watchlist. Nothing else about the listing or shop changes.
reorder_photos
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Set the order buyers see the photos in. Pass the photo_ids in the order you want; any photo you leave out keeps its current place.
revert_change
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Restore the value a listing had before a given change. The history is kept — the rollback is appended as its own entry rather than erasing anything. Offer this the moment the user says the result is wrong. Note it restores the value in MakeBox; if the change had already been pushed, publish again to put the old value back on Etsy.
save_asset
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Put an item in the seller's Asset Library: a listing name worth reusing, a link, a design or a file reference. Pass a folder name to file it — the folder is created if it does not exist yet. Use it when the seller says 'save that name', 'keep this link', 'add that to my library'. Costs nothing.
save_to_watchlist
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Save or update one listing, shop, tag or keyword reference in the connected workspace's MakeBox watchlist. Supply kind and ref, and optionally a label and folder name. A named folder is resolved or created for that kind. Re-saving an existing reference with a folder assigns it there; omitting folder preserves its existing assignment. The seller must approve the save with confirm:true. This stores a reference and label; it does not perform keyword research, save full research statistics or change Etsy.
search_categories
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Search Etsy's seller taxonomy — the ~6000 categories a listing can sit in — by words from the product, e.g. 'wall sign' or 'enamel pin'. Returns full paths like 'Home & Living > Home Decor > Signs' with the id set_listing_category needs. The category drives which attributes Etsy asks for and where buyers browse, so getting it right matters more than it looks.
search_keywords
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Look up Etsy search terms in the MakeBox keyword database, with monthly search volume, how many listings compete for them, and an opportunity score (demand weighed against competition). Ranked by opportunity, not raw volume. Ask for up to 100 at a time and filter by demand or competition to build a shortlist worth arguing about — then confirm your picks with check_keywords. NEVER recommend a term containing someone else's brand or trademark (a company, a character, a franchise, or a phrase like 'dupe'/'inspired by' attached to one): those terms look like easy openings precisely BECAUSE competition is low, and the low competition is Etsy removing the listings. Using one gets the listing taken down and the shop struck.
search_top_listings
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. The actual Etsy listings ranking highest for a search phrase, in Etsy's own order — title, price, tags, views, favourites, a link, and for each one the SHOP: its name, lifetime sales, rating and review count. Etsy publishes no per-listing sales figure, so do not state one and do not estimate it. This is the raw material for judging a niche: competitor_tags tells you which tags that set shares, this tells you WHAT the set is, so you can see how the leaders title and price a product before deciding how to position one. Public Etsy data; nobody needs to be connected to MakeBox. This convenience tool returns at most 50 items. For larger same-query samples, pagination or delivery-country filtering, use etsy_find_all_listings_active with limit up to 100, offset and buyer_country. Do not substitute different queries for pages of one query. Read only what is relevant — a tag that fits their product and not the seller's is a wasted slot, not an opportunity. Costs nothing.
set_listing_category
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Set the saved Etsy taxonomy category for a listing in the connected workspace. Get category_id from search_categories or browse_categories. confirm:true requires the seller's approval. publish:false saves only in MakeBox; otherwise the existing listing is sent through the standard listing push without changing its publication state. The response reports on_etsy and any push problem. This tool does not edit variation axes or the price/stock table.
set_listing_offerings
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Set the price and stock for each combination of variations — this is what actually makes 'Large costs more' true. Declaring affects_price on an axis is not enough on its own: without these, every combination is pushed to Etsy at the listing's base price. Set the variations first, then call this. Replaces the entire saved price/stock table. Default attempts to send and verify on Etsy; only sync_status: verified confirms success. Prefer publish: false to stage the complete table, then push_listing_variations with confirm: true after seller approval.
set_listing_personalization
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Replace the listing's complete set of buyer custom-option fields, up to five text, dropdown or upload questions. Read get_listing_personalization first; an empty fields array removes the questions. Optional text questions may include a seller-approved add-on price. confirm:true requires approval of the complete replacement. publish:false stages only in MakeBox; otherwise only the personalization endpoint is changed, then read back including all prices. Text limits are 1–1024; optional text fields accept a fixed add-on price in shop currency, not a per-letter formula. This tool does not edit listing text, inventory, variations or publication state.
set_listing_return_policy
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Assign one of this shop's existing return policies to an Etsy DRAFT without publishing it. Call list_return_policies first, show the seller whether that exact policy accepts returns and exchanges, and get their approval. Never invent a policy or infer 'no returns' from the product category. This tool checks the policy live, PATCHes only return_policy_id, reads the draft back from Etsy, and updates MakeBox only after verification.
set_listing_section
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Put a listing into one of the shop's own sections (the seller's categories, e.g. 'Acrylic Signs'), or clear it. Call list_sections first to get the section id. Saved in MakeBox only — push_listing_to_etsy sends it live.
set_listing_shipping_profile
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Assign one of this shop's existing shipping profiles to a physical Etsy listing. Call list_shipping_profiles and get_shipping_profile first, then show the seller the exact listing and the profile's destinations and charges; ask for approval because an active listing's buyer-facing shipping price changes immediately. This tool validates the profile in Etsy, PATCHes only shipping_profile_id, reads the listing back, and updates MakeBox only after verification. It does not edit the shared profile or change listing state.
set_listing_state
ChatGPTAVAILABLE for this account; upstream limitations and tool requirements still apply. Decide where a listing lives on Etsy. "draft" is real but invisible to buyers — the safe place to build and check one. "active" makes it live and buyable. "inactive" takes a live listing back down without deleting it; use this to undo an activation. Etsy needs at least one photo before it will activate anything. Nothing else about the listing is changed, and this is the ONLY tool that moves a listing between these states — editing or pushing a listing never activates it by itself.
set_listing_translation
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Attach YOUR translation of a listing's title, description and tags to the live Etsy listing for one language, so shoppers browsing in that language read their own copy. MakeBox does not translate — you write it, this stores it. Works on a DRAFT as well as a published listing — Etsy only needs the listing to exist on its side. Call list_shop_languages FIRST: Etsy refuses a translation for a language the shop has not enabled in Shop Manager. One listing carries all its languages; there is never a separate listing per language. Calling it again for the same language replaces that language's copy.
set_listing_variations
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Replace the variation axes on a listing — for example Size (Small, Medium, Large) or Colour (Black, White). This REPLACES the whole set, so pass every axis you want to keep, not just the new one; read them first with get_listing_variations. Etsy allows at most 3 axes and 70 options each. IMPORTANT limits on the number of combinations (axis options multiplied together): at most 400 when the price or stock differs for EVERY combination, otherwise 2500 with three axes. So 10x10x10 with a price per combination is refused, while the same grid priced by one axis alone is fine — if a seller needs a price per combination, split the third axis into separate listings. Etsy is still rolling three axes out shop by shop, so a third one can come back refused for that shop. By default attempts to send to Etsy and verify the result; only sync_status: verified confirms success. Recommended: stage axes with publish: false, stage the full prices/stock using set_listing_offerings with publish: false, then push_listing_variations with confirm: true after seller approval. A failed send keeps the local configuration.
set_main_photo
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Choose which photo Etsy shows first — the image buyers see in search results and at the top of the listing. Applied on the live Etsy listing in the same call: the photo is moved to first place there, not just in MakeBox. Get photo_id from list_photos. Pass publish: false to change the order in MakeBox only.
set_photo_alt_text
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Write the alt-text for one photo — what a screen reader announces and what Etsy's search reads. Saved in MakeBox. IMPORTANT: Etsy has no way to change the alt-text of a photo that is already on a listing; it can only be set as the photo is uploaded. So this applies it the only way Etsy allows: the photo is detached and immediately re-attached by its Etsy image id with the new text — the file itself is not uploaded again and the photo keeps its position. Pass publish: false to save in MakeBox only.
start_bulk_seo
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Rewrite the SEO of many listings in one background job — the flagship bulk action. Charges the seller upfront, so quote_bulk_seo first, say the price, and only then call this with confirm: true. It returns a job_id immediately; the work continues in the background. Nothing reaches Etsy until push_bulk_seo_job is called.
start_niche_report
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Create a saved evidence-backed niche/product report from up to600 unique public Etsy listings: adjacent search phrases,30 keywords with available source/date/region estimates,20 product leaders,10 shops,3 concrete listing ideas. Active Pro/Studio; NO connected Etsy shop required. Costs2 listing credits once; cached reopen free; failed jobs refunded. Obtain user confirmation of2 credits, then pass confirmCost:2 and a fresh UUID idempotencyKey. Reuse that key after timeout; never blind retry a new key. Returns a job; poll get_niche_report at10-second intervals. Public sample presence/reviews are not exact sales or search demand. Read source/methodology fields. Browser checks of missing variants/prices only when the user explicitly requests them; never claim the report checked them. No Etsy writes.
stop_monitoring_shop
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Remove a competitor from daily monitoring. The seller's own listings are untouched.
translate_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Translate a listing's title, description and tags into other Etsy languages and attach them to the live Etsy listing, so shoppers browsing in that language see their own copy. The listing must already be published to Etsy. Quote it first with quote_translation and tell the user the price.
undo_bulk_edit
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Put back the values a previous bulk_edit_listings call replaced, using the undo it returned. Restores in MakeBox; if the edit was already pushed, push the listings again afterwards to carry the restore to Etsy.
update_asset
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Edit one item in the Asset Library: change its title, move it to another folder (by name — created if new), or update its notes. Pass only what changes. Use list_assets first to get the id.
update_listing
ChatGPTRequires active Pro/Studio, checked live on every call. Never infer current access from cached discovery; use get_account_status. Change a listing and send the change to Etsy in the same step. It edits the listing WHERE IT ALREADY IS: a draft is updated as a draft and stays invisible to buyers, an active listing is updated live. It never activates anything — set_listing_state is the only thing that does. On an active listing this changes what buyers see and Etsy keeps no undo, so read the change back to the seller first. Only the fields you pass are changed. Pass publish: false to stage the edit in MakeBox without touching Etsy.
