Etsy
E-commerceRun an Etsy shop from your flows. Agents create and publish listings with images and inventory, sync orders into fulfillment and accounting systems, push tracking numbers back to buyers, and monitor reviews and the payment ledger through the Etsy Open API v3.
What This Integration Enables
Etsy is a marketplace, not your own storefront, and it has house rules: activating a listing charges a fee, the inventory endpoint is a full replace that overwrites everything you do not resend, and shipment updates trigger notifications Etsy sends to your buyer on your behalf. This connector is built for those rules rather than around them. Update Listing Inventory defaults to a fetch-merge-sanitize cycle, applying a new price or quantity across offerings without touching the structure, so the endpoint that most often destroys variation data becomes routine. Listings are created as drafts by design, keeping the publish moment, and its fee, as a deliberate step. With that footing, agents run the whole shop loop through the Etsy Open API v3: building and updating listings with images and variations, syncing receipts into fulfillment and accounting systems, pushing tracking numbers back to buyers, watching reviews, and reconciling the payment ledger.
Without FlowRunner
With FlowRunner
Use Case Scenarios
Orders Shipped Without the Morning Ritual
The agent polls List Shop Receipts for paid, unshipped orders, buys a label for each through [Shippo](/integrations/shippo), and records the carrier and tracking code with Create Receipt Shipment. That single call marks the order shipped and triggers Etsy's shipping notification to the buyer. Line items from List Receipt Transactions flow into the accounting system with fees reconciled against List Payment Ledger Entries. The maker's morning starts at the workbench, not the order screen.
One Inventory, Every Channel
Prices and stock live in a [Google Sheets](/integrations/google-sheets) inventory sheet that also feeds other channels. On change, the agent maps each row to its listing and applies the new price or quantity with Update Listing Inventory, scoped by SKU filter where only some variations moved. Because the connector merges into the current inventory structure before writing, a price update never flattens a listing's variations. Sold-out SKUs surface for a restock decision instead of quietly overselling.
Reviews Watched, Answered by a Person
Daily, the agent pulls List Shop Reviews and compares against yesterday's set. New five-star reviews roll into a weekly digest. A low-star review gets different treatment: the agent pairs it with its order via Get Receipt, drafts context for the owner, and sends an alert through [Gmail](/integrations/gmail-service) immediately. The response itself stays human, because a template apology to a disappointed buyer reads exactly like what it is.
Human-in-Loop Highlight
Activation is the moment a listing starts costing and selling: Etsy charges its listing fee when a draft goes live, and the listing is in front of buyers from that second. So the publishing agent stages everything and stops at the fee line. It posts: "14 drafts staged for the spring collection, images and variations verified against Get Listing Inventory. Activating publishes each listing and incurs Etsy's listing fee per listing. Activate all 14, hold any back, or start with the three flagship SKUs?" The owner decides what goes live and when, and the agent runs Update Listing to activate exactly that set. The same [human-in-the-loop](/concepts/human-in-the-loop/) gate covers Delete Listing, which permanently removes a listing, and any explicit full replacement through Update Listing Inventory's Products parameter.
Agent Capabilities
26 actionsShop and Account
5- Get Current User Returns the connected account's user id and, for sellers, the shop id that shop-scoped actions default to.
- Get Shop Retrieves the shop's full profile: name, title, announcement, currency, listing counts, review statistics, and vacation status.
- Update Shop Updates the shop's public profile fields: title, announcement, and the messages buyers receive after purchase. Only provided fields change.
- List Shop Sections Lists the shop's custom sections with title, rank, and active listing count.
- Create Shop Section Creates a section for organizing listings; assign it to listings via Update Listing.
Listings
6- List Shop Listings Lists listings filtered by state (Active, Inactive, Draft, Expired, Sold Out) with pagination and sorting. The inventory of what the shop is actually offering.
- Get Listing Retrieves one listing with optional associated data: Images, Shop, User, Translations, Videos, Personalization, and BuyerPrice.
- Get Listings by IDs Retrieves up to 100 listings in one call by their ids, with the same optional associations.
- Create Draft Listing Creates a listing in the Draft state with title, description, price, quantity, and taxonomy category; physical listings add a shipping profile. Nothing publishes and no fee is charged until activation.
- Update Listing Updates listing attributes including state, which is how a draft is activated or a listing deactivated. Activating incurs Etsy's listing fee, so activation is routed for sign-off. Price and quantity live in Update Listing Inventory instead.
- Delete Listing Permanently deletes a listing, allowed only in the states Etsy permits. Routed through the same human gate as activation.
Inventory and Variations
3- Get Listing Inventory Retrieves the listing's full inventory structure: products, SKUs, variation properties, and offerings with price, quantity, and enabled flags. Read before any inventory write.
- Update Listing Inventory Updates prices, quantities, SKUs, and variations against an endpoint that is a full replace at the API level. By default the connector fetches current inventory, applies your changes (optionally scoped by SKU), strips the fields Etsy rejects, and writes the merged result back.
- Get Taxonomy Properties Retrieves the variation properties a taxonomy category supports, with valid values and scales, for building correct variations.
Images
3- List Listing Images Lists a listing's images in rank order with URLs, alt text, and color data.
- Upload Listing Image Uploads an image from FlowRunner file storage with display rank, alt text, and an overwrite flag. Rank 1 is the primary image buyers see first.
- Delete Listing Image Deassociates an image from a listing. Etsy retains deleted listing images for 30 days, so a re-upload within that window restores it.
Orders and Fulfillment
5- List Shop Receipts Lists orders with buyer, shipping address, payment status, and totals, filterable by date and paid, shipped, or delivered status. The polling surface for fulfillment flows.
- Get Receipt Retrieves one order in full, including shipments with tracking and all line-item transactions.
- Update Receipt Sets an order's shipped or paid flags directly. For tracking numbers and buyer notification, Create Receipt Shipment is the right call.
- Create Receipt Shipment Records a shipment with tracking code and carrier, marks the order shipped, and triggers Etsy's shipping notification to the buyer. Duplicate tracking codes on the same receipt are rejected.
- List Receipt Transactions Lists an order's line items with quantity, SKU, price, shipping cost, and personalization. The detail accounting systems need.
Reviews and Finances
2- List Shop Reviews Lists buyer reviews with star rating, text, and the reviewed listing and transaction, filterable by date.
- List Payment Ledger Entries Lists the payment account ledger (sales, fees, refunds, deposits) within a required date range, with amounts and running balance. The reconciliation source of truth.
Catalog Reference
2- List Shipping Profiles Lists the shop's shipping profiles with processing times and per-destination costs. Required for creating physical listings.
- List Seller Taxonomy Nodes Returns Etsy's full category tree flattened with human-readable paths, so agents resolve the right taxonomy id for each product.
Frequently Asked Questions
What can FlowRunner do with Etsy?
FlowRunner agents can run Get Current User, Get Shop, and Update Shop in Etsy, plus 23 more actions.
Does connecting Etsy to FlowRunner require OAuth?
Yes. Etsy connects to FlowRunner with OAuth 2.0, so agents authenticate without handling raw credentials.
Can Etsy trigger a FlowRunner workflow automatically?
Etsy doesn't currently expose triggers in FlowRunner. It connects as an action step inside workflows started by another trigger.
Start building with Etsy
$100 in credits. No card required. Connect in minutes.