Overview
The FlowQ Etsy integration connects your Etsy shop directly to your FlowQ print farm. Once it's linked, FlowQ pulls in new Etsy orders, matches each line item to a print file you've mapped, and (if you want) drops the right number of copies straight into your print queue. That removes the manual loop of opening every order, finding the right file, and adding it to the queue yourself.
It's built for shops that print made to order and want the print queue to mirror what's actually selling.
How It Works
The integration runs on three pieces working together:
-
- Connection. You authorize FlowQ to read your Etsy shop through Etsy's standard OAuth login.
- Mappings. Each Etsy listing (or listing variation) is linked to one or more print files in FlowQ, with a per-unit quantity and a filament profile for each file.
- Settings. Toggles control whether matched orders auto queue and how orders with personalization are handled.
When a new Etsy order comes in, FlowQ looks up the listing in your mappings. If a mapping exists and auto-queue is on, every print file attached to that mapping is added to the queue, with the per-unit quantity multiplied by the order quantity. If a mapping is missing, or the order has personalization and personalization is set to skip, the order is held for manual review instead.
Setting Up the Integration
1. Open the Apps Hub
From the FlowQ sidebar, open the Apps page. This is the central hub for every FlowQ integration, including Shopify, Etsy, Zapier, Make, and any custom apps.
2. Connect Your Etsy Shop
Click into the Etsy tile to open the integration page, then click Connect Etsy shop. You'll be sent through Etsy's standard OAuth flow to authorize FlowQ. Once you approve access, you're returned to FlowQ with the connection live.
3. Confirm the Connection
After connecting, the Overview tab shows your live connection status and recent order activity. Use Refresh orders to pull the latest orders from Etsy at any time.
Mapping Listings to Print Files
Mappings tell FlowQ what to print when an order for a given Etsy listing comes in. Without a mapping, FlowQ has no way to know which file an order corresponds to.
Open the Mappings tab to see every Etsy listing or variation tied to a FlowQ print file, along with the SKU, filament profile, and per-mapping auto queue setting.
Adding a Mapping
Click Add Mapping to link an Etsy listing to its print file (or files). For each mapping you set:
-
- Etsy listing: the product (and variation, if applicable) you're mapping.
- Print file(s): one or more FlowQ files that should be queued when this listing sells. A single listing can be tied to multiple print files, which is useful for multi-part products where the listing is one SKU but the order ships as several prints.
- Quantity per unit: how many copies of each print file to queue per unit ordered. This is set per file, so a multi-part product might queue one of File A and two of File B for every unit sold.
- Filament: the filament profile FlowQ should match when routing each job.
Repeat this for every Etsy listing you want FlowQ to handle. Listings without a mapping still show up in FlowQ, they just won't auto queue.
Settings
The Settings tab controls how the integration behaves shop wide.
-
- Auto-queue orders. When on, new Etsy orders that match a mapping are added to the print queue automatically. When off, orders are still pulled in, but you add them to the queue manually from the Overview.
- Skip orders with personalization. When on, orders that include buyer personalization (names, custom text, anything customer-specific) are skipped by auto queue and held for manual review. This stops FlowQ from blindly queueing a generic file when the buyer asked for something custom.
The Workflow
-
FlowQ receives the order from Etsy.
-
Each line item is looked up against your Mappings.
-
If a mapping exists and Auto-queue orders is on, every print file linked to that mapping is added to the queue, with each file's per-unit quantity multiplied by the order quantity.
-
If the order contains personalization and Skip orders with personalization is on, it's held for you to review instead of being auto-queued.
-
From there, FlowQ's normal queue logic takes over. Routing to compatible printers, looping, and auto-restart all work the same way they do when you queue files manually.
Disconnecting
You can disconnect the Etsy shop at any time from the integration page. Disconnecting stops new orders from being pulled in but leaves your existing mappings in place, so you can reconnect later without rebuilding them.
){kind=link}