Skip to Content

Connect Etsy to Your AI Agent

Find your shop, inspect listings and stock, and review paid orders that still need to ship.

20,000 free app calls every month(paid services billed separately)

Try a Etsy Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo SkillEtsy

Review Shop Inventory

Find your shop's listings and inspect variation inventory for a product.

/oo Etsy: Find my Etsy shop, list its active products, and inspect inventory for [listing ID]. Summarize the quantities and SKUs returned.

Prepare Paid Orders for Shipment

Find paid orders that have not shipped and review their purchased items.

/oo Etsy: Find my Etsy shop's paid, unshipped orders. Review the items in each receipt and summarize what needs packing.

Record a Shipped Package

Record carrier tracking and send the buyer a shipment notification.

/oo Etsy: For Etsy shop [shop ID] and receipt [receipt ID], record shipment with carrier [carrier] and tracking code [code], notifying the buyer.

Start Working with Etsy

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Etsy

    Connect with your own Etsy OAuth application.

    Connect Etsy→
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →
  • An Etsy account and an approved application at https://www.etsy.com/developers/your-apps.
  • Enter the application's keystring as Client ID and its matching shared secret in Shared Secret.
  • Register the exact HTTPS callback URL shown by Connector in the same Etsy application.
  • Default permissions cover account identification, listing reads, order reads, and shipment updates. Keep shops_r when choosing a narrower scope set.
  • Shipment recording and some address fields may require regional preferred-partner access. A valid token alone does not guarantee access.

Etsy Tools

Connect your Etsy account with your own application to read shop listings, inventory, and order receipts. Record shipped packages with tracking information and a buyer notification.

Find Your Shop

Read account identifiers, shop details, and shop sections.

Review Listings and Inventory

Read listings, associations, translations, and variation inventory.

Review Orders and Record Shipments

Filter order receipts, inspect purchased items, and record shipment details.

11 tools

Get Me

Get the connected Etsy user ID and shop ID.

etsy.get_me

Get Shop

Get an Etsy shop's public details.

etsy.get_shop

Get Shop By Owner

Get an Etsy shop by its owner's user ID.

etsy.get_shop_by_owner

List Shop Sections

List the sections of an Etsy shop.

etsy.list_shop_sections

List Shop Listings

List an Etsy shop's listings by state with limit/offset pagination.

etsy.list_shop_listings

Get Listing

Get an Etsy listing with optional associations and translation.

etsy.get_listing

Get Listing Inventory

Read inventory for a listing you own. Listings without Etsy inventory records may have no inventory.

etsy.get_listing_inventory

List Receipts

List Etsy order receipts by dates, payment, shipping, delivery, and cancellation status. Address availability depends on Etsy regional partner access.

etsy.list_receipts

Get Receipt

Get an Etsy order receipt, including available shipping and payment details. Address availability depends on Etsy regional partner access.

etsy.get_receipt

List Receipt Transactions

List the purchased items for an Etsy order receipt.

etsy.list_receipt_transactions

Create Receipt Shipment

Record an Etsy shipment and notify the buyer by email on every successful call. Omit tracking and carrier to mark shipped only; both are required for US domestic orders over $10 and shipments to India. Use carrier 'other' for unsupported carriers. Regional partner restrictions may apply even with valid credentials and scopes.

etsy.create_receipt_shipment

Frequently Asked Questions

Does recording a shipment notify the buyer?

Yes. Every successful shipment submission sends a buyer email. Set send_bcc to true to notify the seller too. This action records a shipment; it does not purchase a shipping label.

Why can I read an order but not record its shipment?

Etsy applies preferred-partner restrictions in some regions. Your application may need approved fulfillment access even when it has transactions_w. Some address fields are also restricted.

How do I retrieve more listings or receipts?

Use limit and offset. Etsy defaults to 25 records, with a maximum of 100 per request. Increase offset to fetch the next page.