# Etsy MCP connector The Etsy connector brings your shop's listings, inventory, photos, and files into Claude, ChatGPT, Cursor, and any MCP client, so your team can create, update, and tidy listings from a chat, inside each person's own Etsy access. Source: https://elaichi.ai/connectors/etsy/ ## Facts | | | | --- | --- | | Application | Etsy | | Category | Ecommerce | | AI tools | 105 | | Authentication | Connects over OAuth | | Needs your own OAuth app | Yes | | MCP endpoint | https://api.elaichi.ai/mcp | | Works with | Claude, ChatGPT, Cursor, any MCP client, and the Elaichi Agent | | Tools advertised by name | No. 105 tools is past the 30-tool threshold, so clients use `search_tools` and `execute_tool` | ## What you can ask once Etsy is connected - Which shop listings are running low on inventory? - Summarize this week's Etsy receipts by status. - Draft a new listing for the fall collection. ## Connect Etsy in Elaichi This happens once for the organization, before any client is involved. 1. Open Connections, choose Add connection, and pick Etsy. 2. Optionally set Share with, then press Connect. 3. Supply your own Etsy app, then approve. Etsy needs an OAuth app you register yourself, so bring its client ID and secret. One person does this once for the organization. Credentials are vaulted and nobody, including the AI, reads them back. The connection becomes a toolbox immediately, so you can curate which Etsy tools are exposed, rename them, or freeze arguments before anyone points a client at it. ## Connect Etsy to Claude Endpoint: https://api.elaichi.ai/mcp 1. Open Customize, then Connectors. 2. Press Add. 3. Name it, paste the MCP server URL, then Continue. 4. Sign in and approve. On Team and Enterprise, an Owner adds it once. Everyone else turns it on for themselves. ## Connect Etsy to ChatGPT Endpoint: https://api.elaichi.ai/mcp 1. Open Plugins, then press the + button. 2. Name it and paste the endpoint into Server URL. 3. Leave Authentication on OAuth, then tick the risk acknowledgement. 4. Press Create, then sign in and approve. Works on the web today. The plugin directory lives at chatgpt.com/plugins. ## Connect Etsy to Cursor Endpoint: https://api.elaichi.ai/mcp 1. Open `~/.cursor/mcp.json`. 2. Add the endpoint under `mcpServers`. 3. Reload Cursor, then sign in and approve. Set up per machine, so repeat it on each computer you work from. ## Connect Etsy to any MCP client Endpoint: https://api.elaichi.ai/mcp 1. Add the endpoint as a remote MCP server. 2. Sign in and approve. The Elaichi Agent already has these tools, with nothing to set up. ## What the consent screen decides Only Read is granted by default, which is not enough to call a Etsy tool. Over MCP there is no trusted place to confirm a write in the moment, so the consent screen is the standing approval rather than a formality. Grant Read and Run tools. Think hard before granting Delete, which reaches into connected apps and cannot be undone. ## What teams do with Etsy through Elaichi ### Draft a new listing from a product brief Shop operations. Describe the item, its price, and its variations in plain language and have the listing created in your Etsy shop with the right category picked from Etsy's own taxonomy. Review it before it goes live. ### Refresh titles and descriptions across active listings Merchandising. Pull up every active listing in the shop, spot the ones with thin or outdated copy, and rewrite them in batches. Featured listings can be checked at the same time so the front of the shop stays current. ### Update stock and prices across many listings at once Inventory. Ask for every listing with a given size or color variation, then adjust quantities and prices in one bulk pass instead of opening each listing by hand. ### Audit listing photos before a seasonal push Marketing. List the images attached to each listing, find items with only one photo or a missing main shot, and add new images straight from the conversation. ### Swap the file behind a digital listing Digital products. When a pattern, printable, or template gets a new version, find the listing, remove the old file, and attach the new one without leaving the chat. ### Fix personalization options a buyer asked about Customer support. When a buyer reports a confusing personalization prompt or character limit, look up the listing and change the personalization instructions on the spot. ## Frequently asked questions ### How do I connect Etsy to Claude? Connecting Etsy takes two steps. First, connect Etsy in Elaichi: Etsy asks you to register an app in your Etsy developer account, so somebody brings its client ID and secret once, then each person signs in with their own Etsy account through Etsy's usual sign-in screen. Second, in Claude open Customize, then Connectors, then Add, and paste https://api.elaichi.ai/mcp. Nobody else on the team has to generate or handle anything after that. ### Does Etsy work with ChatGPT and Cursor as well as Claude? Yes. Once Etsy is connected in Elaichi, the same endpoint, https://api.elaichi.ai/mcp, works in Claude, ChatGPT, Cursor, any other MCP client, and the Elaichi Agent. You connect Etsy once and every client uses it. ### What can an AI agent actually do with my Etsy data? With Etsy connected, an agent can look through your shop's listings, active and featured, and create new ones, update titles, descriptions, and personalization instructions, and change prices and quantities across many listings at once. It can also list, add, and remove the photos and digital files attached to a listing, and pick categories from Etsy's own taxonomy. Etsy exposes a lot of actions, so short concrete asks such as "lower every mug listing to 18 dollars" work better than long paragraphs. ### Does connecting Etsy give the AI access to my whole shop? No. Every call to Etsy runs as the person who signed in, so the agent can only see and change what that person's Etsy account can already reach. Elaichi can narrow that further, for example to reading listings only, but it can never widen it beyond what Etsy itself allows that person. ### Can my team share one Etsy connection? Yes. One person connects the Etsy shop in Elaichi and shares it with a team, and nobody else ever sees or handles a credential. Each teammate still signs in to Elaichi as themselves, so every change to an Etsy listing is logged under the name of the person who made it. ### Can I stop an agent from deleting or changing things in Etsy? Yes. In Elaichi you can block individual actions on Etsy, such as deleting a listing or removing a photo, while leaving reading and updating open. A blocked action is never shown to Claude, ChatGPT, Cursor, or any other client at all, so no prompt, however worded, can reach it. ### What happens to an Etsy connection when someone leaves? Offboarding a person in Elaichi ends their access to Etsy at once, in every client they had connected. If the Etsy shop was shared with a team, the connection keeps working for everyone else. If you disconnect Etsy in Elaichi, it disappears from Claude, ChatGPT, Cursor, and every other client in one step. ## All 105 Etsy tools Every tool below is callable through https://api.elaichi.ai/mcp once Etsy is connected, subject to the toolbox it is in and the restrictions on the caller. - **List all Etsy buyer taxonomy nodes** (List). List the full hierarchy tree of Etsy buyer taxonomy nodes. Returns: id, level, name, parent_id, children, full_path_taxonomy_ids. - **List all Etsy node properties** (List). List product properties with applicable scales and values supported for a specific Etsy buyer taxonomy node. Returns: property_id, property_name, scale_id, scale_name, value_ids, values. Required: taxonomy_id. - **List all Etsy shop listings** (List). List Etsy listings belonging to a shop, optionally filtered by listing state. Returns each listing with listing_id, title, description, state, price, quantity, num_favorers, tags, materials, and timestamps. Required: shop_id. - **Create a Etsy shop listing** (Create). Create a physical draft listing product in an Etsy shop. Returns the created ShopListing including listing_id, title, description, state, price, quantity, and timestamps. shipping_profile_id is required for physical listings. Required: shop_id. - **Update a Etsy shop listing by ID** (Update). Update an Etsy shop listing by id, including title, description, state, shipping profile, pricing, dimensions, tags, and production partner associations. Returns the updated ShopListing including listing_id, title, description, state, price, quantity, url, and timestamps. Required: id, shop_id. - **Get single Etsy application listing by ID** (Get). Get a single Etsy listing by id. Returns the full listing record including listing_id, title, description, price, state, quantity, tags, who_made, when_made, and additional listing attributes including shipping and processing details. Required: id. - **Delete a Etsy application listing by ID** (Delete). Delete an Etsy ShopListing by id. Returns an empty 204 response on success. A listing can be deleted only if its state is SOLD_OUT, DRAFT, EXPIRED, INACTIVE, or ACTIVE with is_available, or ACTIVE with seller flags SUPRESSED, VACATION, CUSTOM_SHOPS, or SELL_ON_FACEBOOK. Required: id. - **Get single Etsy listing file by ID** (Get). Get a single Etsy listing file by id. Returns: listing_file_id, listing_id, rank, filename, filesize, size_bytes, filetype, create_timestamp, created_timestamp. Requesting a file from a physical listing returns an empty result. Required: id, shop_id, listing_id. - **Delete a Etsy listing file by ID** (Delete). Delete an Etsy listing file by id. Returns an empty 204 response on success. Deleting the final file for a digital listing converts it into a physical listing. Required: id, shop_id, listing_id. - **List all Etsy listing files** (List). List all files associated with an Etsy digital listing. Returns: listing_file_id, listing_id, rank, filename, filesize, size_bytes, filetype, create_timestamp, created_timestamp. Requesting files from a physical listing returns an empty result. Required: listing_id, shop_id. - **Create a Etsy listing file** (Create). Upload a new file for an Etsy digital listing, or associate an existing file with a listing. Returns: listing_file_id, listing_id, rank, filename, filesize, size_bytes, filetype, create_timestamp, created_timestamp. Provide either listing_file_id of an existing file, or name and file for a new upload. Required: shop_id, listing_id. - **List all Etsy listings actives** (List).
General ReleaseReport bug
. - **Delete a Etsy listing image by ID** (Delete). Delete an Etsy listing image by id. A copy of the file remains on Etsy servers and may be re-associated with the listing later without re-uploading. Returns an empty 204 response on success. Required: id, shop_id, listing_id. - **Get single Etsy listing image by ID** (Get). Get a single Etsy listing image by id. Returns: listing_id, listing_image_id, hex_code, red, green, blue, hue, saturation, brightness, is_black_and_white, creation_tsz, created_timestamp, rank, url_75x75, url_170x135, url_570xN, url_fullxfull, full_height, full_width, alt_text. Required: id, listing_id. - **List all Etsy listing images** (List). List all listing images for an Etsy listing. Returns: listing_id, listing_image_id, hex_code, red, green, blue, hue, saturation, brightness, is_black_and_white, creation_tsz, created_timestamp, rank, url_75x75, url_170x135, url_570xN, url_fullxfull, full_height, full_width, alt_text. Required: listing_id. - **Create a Etsy listing image** (Create). Upload or assign an image to an Etsy listing by shop_id and listing_id. Provide the image file to upload a new image, or listing_image_id to re-assign a previously deleted image. When both are supplied, only the uploaded image is used. Returns: listing_id, listing_image_id, hex_code, red, green, blue, hue, saturation, brightness, is_black_and_white, creation_tsz, created_timestamp, rank,…. Required: shop_id, listing_id. - **Get single Etsy listing inventory by ID** (Get). Get the inventory record for an Etsy listing by id. Returns the inventory including products (with offerings and property_values), price_on_property, quantity_on_property, sku_on_property, and readiness_state_on_property. SKU data is only returned when you own the inventory. Required: id. - **Etsy listing inventories bulk update** (Update). Update the inventory for an Etsy listing by id. Returns the updated inventory including products (with offerings and property_values), price_on_property, quantity_on_property, sku_on_property, and readiness_state_on_property. The update fails if supplied values for product sku, offering quantity, price, and/or processing profile are incompatible with the *_on_property fields. Required: id, products. - **List all Etsy batch inventories** (List). Retrieve inventory records for multiple Etsy listings by listing ID in a single batch request. Returns: listing_id, products, price_on_property, quantity_on_property, sku_on_property, readiness_state_on_property. Limit 100 listing IDs per request; if any ID is not found the entire request returns a 404. SKUs within product records are stripped (returned as empty string) for…. Required: listing_ids. - **Get single Etsy inventory product by ID** (Get). Get a specific Etsy listing inventory product by id within a listing. Returns: product_id, sku, is_deleted, offerings, property_values. Required: id, listing_id. - **Get single Etsy product offering by ID** (Get). Get a specific product offering for an Etsy listing product. Returns: offering_id, quantity, is_enabled, is_deleted, price, readiness_state_id. Required: id, listing_id, product_id. - **List all Etsy listings batches** (List). Query multiple Etsy listing IDs at once in a single batch request. Returns: listing_id, user_id, shop_id, title, description, rich_description, state, creation_timestamp, created_timestamp, ending_timestamp, original_creation_timestamp, last_modified_timestamp, updated_timestamp, state_timestamp, quantity, shop_section_id, featured_rank, url, num_favorers, non_taxable, is_taxable,…. Required: listing_ids. - **List all Etsy listings featureds** (List). List featured Etsy listings for a shop. Returns listing records including listing_id, title, description, state, price, quantity, created_timestamp, and num_favorers. Required: shop_id. - **Update a Etsy listing personalization by ID** (Update). Create or update personalization settings for an Etsy listing, fully replacing any existing personalization. Returns: personalization_questions. Required: id, shop_id, personalization_questions. - **Get single Etsy listing personalization by ID** (Get). Get a listing's personalization questions in Etsy by listing id. Returns: personalization_questions. Required: id. - **Etsy listing personalizations bulk delete** (Delete). Delete personalization for an Etsy listing. Returns an empty 204 response on success. Required: id, shop_id. - **Update a Etsy listing property by ID** (Update). Update a listing property's values in an Etsy shop, populating the properties that define product offerings for a listing. Returns: property_id, property_name, scale_id, scale_name, value_ids, values. Each offering requires both a value and a value_id valid for the assigned scale_id. Required: id, shop_id, listing_id. - **Delete a Etsy listing property by ID** (Delete). Delete a listing property from an Etsy shop listing. Returns an empty 204 response on success. Required: id, shop_id, listing_id. - **List all Etsy listing properties** (List). List all properties for an Etsy listing in a shop. Returns: property_id, property_name, scale_id, scale_name, value_ids, values. Required: shop_id, listing_id. - **Get single Etsy listing property by ID** (Get). Get a single Etsy listing property by id. Returns: property_id, property_name, scale_id, scale_name, value_ids, values. Required: id, listing_id. - **List all Etsy batch shippings** (List). List shipping profiles for multiple Etsy listings by their listing IDs. Returns: shipping_profile_id, title, user_id, origin_country_iso, is_deleted, shipping_profile_destinations, shipping_profile_upgrades, origin_postal_code, profile_type, domestic_handling_fee, international_handling_fee. Limit 100 listing IDs per request; all requested IDs must exist or the entire…. Required: listing_ids. - **List all Etsy listing transactions** (List). List Etsy transactions associated with a specific listing. Returns: transaction_id, title, description, seller_user_id, buyer_user_id, create_timestamp, created_timestamp, paid_timestamp, shipped_timestamp, quantity, listing_image_id, receipt_id, is_digital, file_data, listing_id, transaction_type, product_id, sku, price, shipping_cost, variations, product_data, shipping_profile_id,…. Required: shop_id, listing_id. - **Create a Etsy listing translation** (Create). Create a listing translation in Etsy for a specific language. Returns: listing_id, language, title, description, tags. Required: shop_id, listing_id, language. - **Update a Etsy listing translation by ID** (Update). Update a listing translation in Etsy for a specific language. Returns: listing_id, language, title, description, tags. Required: id, shop_id, listing_id. - **Get single Etsy listing translation by ID** (Get). Get a listing translation in Etsy for a specific language. Returns: listing_id, language, title, description, tags. Required: id, shop_id, listing_id. - **List all Etsy listing variation images** (List). List all variation images on an Etsy listing. Returns: property_id, value_id, value, image_id. Required: shop_id, listing_id. - **Update a Etsy listing variation image by ID** (Update). Create or overwrite all variation images on an Etsy listing. The update overwrites existing variation images, so the listing will have exactly those you specify. Returns: count, results. Required: shop_id, listing_id, variation_images. - **Delete a Etsy listing video by ID** (Delete). Delete a listing video from an Etsy shop. A copy of the video remains on Etsy's servers and may be re-associated with the listing without re-uploading. Returns an empty 204 response on success. Required: id, shop_id, listing_id. - **List all Etsy listing videos** (List). List all videos associated with an Etsy listing. Returns: video_id, height, width, thumbnail_url, video_url, video_state. Required: listing_id. - **Create a Etsy listing video** (Create). Upload a new video for an Etsy listing or associate an existing video with it. Returns: video_id, height, width, thumbnail_url, video_url, video_state. You must provide either video_id of an existing shop video, or name and video binary file for upload. Required: shop_id, listing_id. - **Get single Etsy listing video by ID** (Get). Get a single video associated with an Etsy listing by id. Returns: video_id, height, width, thumbnail_url, video_url, video_state. Required: id, listing_id. - **List all Etsy payment account ledger entries** (List). List Etsy shop payment account ledger entries filtered by a creation-date range. Returns: entry_id, ledger_id, sequence_number, amount, currency, description, balance, create_date, created_timestamp, ledger_type, reference_type, reference_id, parent_entry_id, payment_adjustments. Required: shop_id, min_created, max_created. - **Get single Etsy payment account ledger entry by ID** (Get). Get a single Etsy shop payment account ledger entry by id. Returns: entry_id, ledger_id, sequence_number, amount, currency, description, balance, create_date, created_timestamp, ledger_type, reference_type, reference_id, parent_entry_id, payment_adjustments. Required: id, shop_id. - **List all Etsy ledger entries payments** (List). List Etsy payments associated with PaymentAccount ledger entry IDs for a shop. Returns each payment with payment_id, buyer_user_id, receipt_id, amount_gross, amount_fees, amount_net, status, and payment_adjustments. Required: shop_id, ledger_entry_ids. - **List all Etsy receipt payments** (List). List payments for a specific Etsy shop receipt. Returns each payment's payment_id, buyer_user_id, shop_id, receipt_id, amount_gross, amount_fees, amount_net, status, currency, and payment_adjustments. Required: shop_id, receipt_id. - **List all Etsy shop payments** (List). List Etsy shop payments filtered by a comma-separated list of payment IDs. Returns each payment record including payment_id, receipt_id, amount_gross, amount_fees, amount_net, status, currency, and payment_adjustments. Required: shop_id, payment_ids. - **List all Etsy application openapi pings** (List). Check connectivity to the Etsy Open API by confirming an application has access. Returns: application_id. - **List all Etsy shop receipts** (List). List Etsy shop receipts from a specific shop, optionally filtered by date range, payment, shipping, delivery, or cancellation status. Returns: receipt_id, receipt_type, seller_user_id, seller_email, buyer_user_id, buyer_email, name, first_line, second_line, city, state, zip, status, formatted_address, country_iso, payment_method, payment_email, message_from_seller, message_from_buyer,…. Required: shop_id. - **Update a Etsy shop receipt by ID** (Update). Update the payment or shipping status of an Etsy shop receipt by id. Returns the updated receipt including receipt_id, status, is_paid, is_shipped, grandtotal, subtotal, transactions, shipments, and refunds. Required: id, shop_id. - **Get single Etsy shop receipt by ID** (Get). Get a single Etsy shop receipt by id. Returns the full receipt object including receipt_id, status, is_paid, is_shipped, grandtotal, subtotal, transactions, shipments, and refunds. Required: id, shop_id. - **List all Etsy receipt listings** (List). List all Etsy listings associated with a specific shop receipt. Returns: listing_id, user_id, shop_id, title, description, language, state, price, currency_code, quantity, tags, materials, styles, who_made, when_made, is_supply, is_customizable, is_personalizable, is_digital, should_auto_renew, is_taxable, type, taxonomy_id, shipping_profile_id, return_policy_id, shop_section_id, processing_min,…. Required: receipt_id, shop_id. - **Create a Etsy receipt tracking** (Create). Submit tracking information for an Etsy Shop Receipt, creating a Shop Receipt Shipment entry and triggering a buyer notification email. Returns the full ShopReceipt object including receipt_id, status, is_shipped, shipments, grandtotal, and transactions. For US orders over $10 or shipments to India, tracking_code and carrier_name are required; use 'other' as…. Required: shop_id, receipt_id. - **List all Etsy receipt transactions** (List). List transactions associated with a specific Etsy receipt. Returns: transaction_id, title, description, seller_user_id, buyer_user_id, create_timestamp, created_timestamp, paid_timestamp, shipped_timestamp, quantity, listing_image_id, receipt_id, is_digital, file_data, listing_id, transaction_type, product_id, sku, price, shipping_cost, variations, product_data, shipping_profile_id,…. Required: shop_id, receipt_id. - **List all Etsy listing reviews** (List). List reviews for an Etsy listing by its ID. Returns: shop_id, listing_id, rating, review, language, image_url_fullxfull, create_timestamp, created_timestamp, update_timestamp, updated_timestamp. Use min_created and max_created to filter by unix timestamp range. Required: listing_id. - **List all Etsy shop reviews** (List). List transaction reviews for an Etsy shop by shop ID, optionally filtered by creation timestamp range. Returns: shop_id, listing_id, transaction_id, buyer_user_id, rating, review, language, image_url_fullxfull, create_timestamp, created_timestamp, update_timestamp, updated_timestamp. Max 100 results per page. Required: shop_id. - **List all Etsy seller taxonomy nodes** (List). List the full hierarchy tree of Etsy seller taxonomy nodes. Returns: id, level, name, parent_id, children, full_path_taxonomy_ids. No required parameters. - **List all Etsy application shipping carriers** (List). List available Etsy shipping carriers and their associated mail classes for a given origin country. Returns: shipping_carrier_id, name, domestic_classes, international_classes. Required: origin_country_iso. - **Get single Etsy application shop by ID** (Get). Get a single Etsy shop by id. Returns the full Shop object including shop_id, user_id, shop_name, title, announcement, currency_code, is_vacation, listing_active_count, review_average, and more. Required: id. - **Update a Etsy application shop by ID** (Update). Update an Etsy shop's title, announcement, sale messages, and additional policy. Returns the updated Shop object including shop_id, user_id, shop_name, title, announcement, and currency_code. String parameters must be in the shop's primary language; policy_additional should only be set for EU shops. Required: id. - **List all Etsy application shops** (List). Search Etsy shops by name. Returns a list of Shop objects including shop_id, shop_name, title, announcement, currency_code, listing_active_count, and review_average for each result. Required: shop_name. - **List all Etsy user shops** (List). Get the Etsy shop owned by a specific user by their user ID. Returns: shop_id, user_id, shop_name, create_date, created_timestamp, title, announcement, currency_code, is_vacation, vacation_message, sale_message, digital_sale_message, update_date, updated_timestamp, listing_active_count, digital_listing_count, login_name, accepts_custom_requests, policy_welcome, policy_payment, policy_shipping,…. Required: user_id. - **List all Etsy shop holiday preferences** (List). List holidays available to an Etsy shop for setting a processing preference. Returns: shop_id, holiday_id, country_iso, is_working, holiday_name. Currently only supported in the US and CA. Required: shop_id. - **Update a Etsy shop holiday preference by ID** (Update). Update whether an Etsy shop will process orders on a specific holiday. Returns: shop_id, holiday_id, country_iso, is_working, holiday_name. Currently only supported in the US and CA. Required: id, shop_id. - **Create a Etsy return consolidate** (Create). Consolidate Etsy return policies by moving all listings from a source return policy to a destination return policy and deleting the source. Returns the updated destination return policy object including return_policy_id, shop_id, accepts_returns, accepts_exchanges, and return_deadline. Required: shop_id. - **List all Etsy policies returns** (List). List all return policies for an Etsy shop. Returns: return_policy_id, shop_id, accepts_returns, accepts_exchanges, return_deadline. Required: shop_id. - **Create a Etsy policies return** (Create). Create a new return policy for an Etsy shop. Returns: return_policy_id, shop_id, accepts_returns, accepts_exchanges, return_deadline. If accepts_returns or accepts_exchanges is true, return_deadline is required. Required: shop_id. - **Update a Etsy policies return by ID** (Update). Update an existing return policy for an Etsy shop. Returns: return_policy_id, shop_id, accepts_returns, accepts_exchanges, return_deadline. If accepts_returns or accepts_exchanges is true, return_deadline is required. Required: id, shop_id. - **Delete a Etsy policies return by ID** (Delete). Delete an existing Returns an empty 204 response on success. Returns an empty 204 response on success. Deletion is only allowed for policies with no associated listings. Required: id, shop_id. - **Get single Etsy policies return by ID** (Get). Get a single return policy from an Etsy shop by id. Returns: return_policy_id, shop_id, accepts_returns, accepts_exchanges, return_deadline. Required: id, shop_id. - **List all Etsy listings** (List). List all Etsy shop listings associated with a specific Return Policy. Returns: listing_id, user_id, shop_id, title, description, rich_description, state, creation_timestamp, created_timestamp, ending_timestamp, original_creation_timestamp, last_modified_timestamp, updated_timestamp, state_timestamp, quantity, shop_section_id, featured_rank, url, num_favorers, non_taxable, is_taxable,…. Required: return_policy_id, shop_id. - **List all Etsy shop production partners** (List). List production partners available in a specific Etsy shop. Returns: production_partner_id, partner_name, location. Required: shop_id. - **List all Etsy shop readiness state definitions** (List). List Etsy shop readiness state definitions (processing profiles) for a specific shop. Returns: shop_id, readiness_state_id, readiness_state, min_processing_days, max_processing_days, processing_days_display_label. Max 100 per page. Required: shop_id. - **Create a Etsy shop readiness state definition** (Create). Create a new Etsy shop readiness state definition (processing profile). Returns: shop_id, readiness_state_id, readiness_state, min_processing_days, max_processing_days, processing_days_display_label. Throws a 409 Conflict error if an existing definition already matches the input values. Required: shop_id. - **Update a Etsy shop readiness state definition by ID** (Update). Update an existing Etsy shop readiness state definition (processing profile) by id. Returns: shop_id, readiness_state_id, readiness_state, min_processing_days, max_processing_days, processing_days_display_label. Throws a 409 Conflict error if an existing definition already matches the input values. Required: id, shop_id. - **Delete a Etsy shop readiness state definition by ID** (Delete). Delete an Etsy shop readiness state definition by id. Returns an empty 204 response on success. Cannot delete a definition that is linked to active offerings; re-link those offerings first. Required: id, shop_id. - **Get single Etsy shop readiness state definition by ID** (Get). Get a single Etsy shop readiness state definition (processing profile) by id. Returns: shop_id, readiness_state_id, readiness_state, min_processing_days, max_processing_days, processing_days_display_label. Required: id, shop_id. - **List all Etsy shop sections** (List). List Etsy shop sections for a specific shop. Returns: shop_section_id, title, rank, user_id, active_listing_count. Required: shop_id. - **Create a Etsy shop section** (Create). Create a new section in an Etsy shop. Returns: shop_section_id, title, rank, user_id, active_listing_count. Required: shop_id. - **Get single Etsy shop section by ID** (Get). Get a single Etsy shop section by id. Returns: shop_section_id, title, rank, user_id, active_listing_count. Required: id, shop_id. - **Update a Etsy shop section by ID** (Update). Update the title of an Etsy shop section by id. Returns: shop_section_id, title, rank, user_id, active_listing_count. Required: id, shop_id. - **Delete a Etsy shop section by ID** (Delete). Delete an Etsy shop section by id. Returns an empty 204 response on success. Required: id, shop_id. - **List all Etsy shop sections listings** (List). List all Etsy listings belonging to one or more sections of a specific shop. Returns: listing_id, title, description, language, tags. Max 100 results per page. Required: shop_id, shop_section_ids. - **List all Etsy shop shipping profiles** (List). List shipping profiles for an Etsy shop. Returns each profile with: shipping_profile_id, title, user_id, origin_country_iso, is_deleted, shipping_profile_destinations, shipping_profile_upgrades, origin_postal_code, profile_type, domestic_handling_fee, international_handling_fee. Required: shop_id. - **Create a Etsy shop shipping profile** (Create). Create a new shipping profile for an Etsy shop. Returns: shipping_profile_id, title, user_id, origin_country_iso, is_deleted, shipping_profile_destinations, shipping_profile_upgrades, origin_postal_code, profile_type, domestic_handling_fee, international_handling_fee. Pass either destination_country_iso or…. Required: shop_id. - **Update a Etsy shop shipping profile by ID** (Update). Update an existing Etsy shipping profile by id. Returns: shipping_profile_id, title, user_id, origin_country_iso, is_deleted, shipping_profile_destinations, shipping_profile_upgrades, origin_postal_code, profile_type, domestic_handling_fee, international_handling_fee. Required: id, shop_id. - **Delete a Etsy shop shipping profile by ID** (Delete). Delete an Etsy shipping profile by id. Returns an empty 204 response on success. Required: id, shop_id. - **Get single Etsy shop shipping profile by ID** (Get). Get a single Etsy shipping profile by id. Returns: shipping_profile_id, title, user_id, origin_country_iso, is_deleted, shipping_profile_destinations, shipping_profile_upgrades, origin_postal_code, profile_type, domestic_handling_fee, international_handling_fee. Required: id, shop_id. - **List all Etsy shipping profile destinations** (List). List shipping profile destinations associated with an Etsy shipping profile. Returns: shipping_profile_destination_id, shipping_profile_id, origin_country_iso, destination_country_iso, destination_region, primary_cost, secondary_cost, shipping_carrier_id, mail_class, min_delivery_days, max_delivery_days. Required: shop_id, shipping_profile_id. - **Create a Etsy shipping profile destination** (Create). Create a new shipping destination for an Etsy shipping profile, setting shipping cost, carrier, and class. Returns: shipping_profile_destination_id, shipping_profile_id, origin_country_iso, destination_country_iso, destination_region, primary_cost, secondary_cost, shipping_carrier_id, mail_class, min_delivery_days, max_delivery_days. Required: shop_id, shipping_profile_id. - **Update a Etsy shipping profile destination by ID** (Update). Update an existing Etsy shipping profile destination by id, reassigning shipping cost, carrier, and class. Returns: shipping_profile_destination_id, shipping_profile_id, origin_country_iso, destination_country_iso, destination_region, primary_cost, secondary_cost, shipping_carrier_id, mail_class, min_delivery_days, max_delivery_days. Required: id, shop_id, shipping_profile_id. - **Delete a Etsy shipping profile destination by ID** (Delete). Delete an Etsy shipping profile destination by id. Cannot delete the final remaining destination of a shipping profile; delete the entire shipping profile instead. Returns an empty 204 response on success. Required: id, shop_id, shipping_profile_id. - **List all Etsy shipping profile upgrades** (List). List shipping profile upgrades assigned to a specific Etsy shipping profile. Returns each upgrade's upgrade_id, upgrade_name, type, price, secondary_price, shipping_carrier_id, mail_class, min_delivery_days, and max_delivery_days. Required: shop_id, shipping_profile_id. - **Create a Etsy shipping profile upgrade** (Create). Create an Etsy shipping profile upgrade for an alternate carrier or faster delivery. Returns: shipping_profile_id, upgrade_id, upgrade_name, type, rank, language, price, secondary_price, shipping_carrier_id, mail_class, min_delivery_days, max_delivery_days. Either (shipping_carrier_id + mail_class) or…. Required: shop_id, shipping_profile_id. - **Update a Etsy shipping profile upgrade by ID** (Update). Update an Etsy shipping profile upgrade; any listings using the shipping profile are also updated. Returns: shipping_profile_id, upgrade_id, upgrade_name, type, rank, language, price, secondary_price, shipping_carrier_id, mail_class, min_delivery_days, max_delivery_days. Required: id, shop_id, shipping_profile_id. - **Delete a Etsy shipping profile upgrade by ID** (Delete). Delete an Etsy shipping profile upgrade and remove the upgrade option from every listing using the associated shipping profile. Returns an empty 204 response on success. Required: id, shop_id, shipping_profile_id. - **Create a Etsy application scope** (Create). Check the OAuth scopes of a provided token in Etsy. Returns the scopes granted to the token as a list of scope strings. - **List all Etsy shop transactions** (List). List Etsy shop transactions for a given shop. Returns each transaction record with transaction_id, title, description, seller_user_id, buyer_user_id, create_timestamp, created_timestamp, paid_timestamp, shipped_timestamp, quantity, listing_image_id, receipt_id, is_digital, file_data, listing_id, transaction_type, product_id, sku, price (amount/divisor/currency_code), shipping_cost, variations,…. Required: shop_id. - **Get single Etsy shop transaction by ID** (Get). Get a single Etsy shop transaction by id. Returns: transaction_id, title, description, seller_user_id, buyer_user_id, create_timestamp, created_timestamp, paid_timestamp, shipped_timestamp, quantity, listing_image_id, receipt_id, is_digital, file_data, listing_id, transaction_type, product_id, sku, price, shipping_cost, variations, product_data, shipping_profile_id, min_processing_days,…. Required: id, shop_id. - **Get single Etsy user address by ID** (Get). Get a single Etsy user address by id. Returns: user_address_id, user_id, name, first_line, second_line, city, state, zip, iso_country_code, country_name, is_default_shipping_address. Required: id. - **Delete a Etsy user address by ID** (Delete). Delete an Etsy user address by id. Returns an empty 204 response on success. Required: id. - **List all Etsy user addresses** (List). List Etsy user addresses for the authenticated user. Returns: user_address_id, user_id, name, first_line, second_line, city, state, zip, iso_country_code, country_name, is_default_shipping_address. - **Get single Etsy application user by ID** (Get). Get a single Etsy user profile by user ID. Returns: user_id, primary_email, first_name, last_name, image_url_75x75. Access is limited to the authenticated user or linked buyers; primary_email requires additional app-based permissions granted case-by-case. Required: id. - **List all Etsy application users** (List). Get basic info for the authenticated Etsy user making the request. Returns: user_id, shop_id. - **List all Etsy seller taxonomy node properties** (List). List product properties, with applicable scales and possible values, supported for a specific Etsy seller taxonomy node. Returns: property_id, name, display_name, scales, is_required, supports_attributes, supports_variations, is_multivalued, max_values_allowed, possible_values, selected_values. Required: taxonomy_id. - **List all Etsy shop active listings** (List). List all active Etsy listings in a specific shop, paginated by listing creation date. Returns each listing with listing_id, title, description, state, price, quantity, and additional listing attributes. Required: shop_id.