Etsy
API integration

list_all_etsy_buyer_taxonomy_nodes

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 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 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 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 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 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 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 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 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 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

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

delete_a_etsy_listing_image_by_id

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 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 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

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 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 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

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 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 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

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 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

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 a listing's personalization questions in Etsy by listing id. Returns: personalization_questions. Required: id.

etsy_listing_personalizations_bulk_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 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 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 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 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 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 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 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 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 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 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

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 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 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

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 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 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 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 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 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 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

Check connectivity to the Etsy Open API by confirming an application has access. Returns: application_id.

list_all_etsy_shop_receipts

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 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 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 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

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 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 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 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 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 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 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 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

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

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 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 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

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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 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 an Etsy shop section by id. Returns an empty 204 response on success. Required: id, shop_id.

list_all_etsy_shop_sections_listings

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 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 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 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 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 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 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 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 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 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 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 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 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 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

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 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 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 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 an Etsy user address by id. Returns an empty 204 response on success. Required: id.

list_all_etsy_user_addresses

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 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

Get basic info for the authenticated Etsy user making the request. Returns: user_id, shop_id.

list_all_etsy_seller_taxonomy_node_properties

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 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.