Etsy and Printful integration

Etsy and Printful integrations that keep orders moving

Selling on Etsy and fulfilling with Printful means four moving parts: listings, orders, production and tracking. We built that whole loop in Salestreak: publish a product with its variants to Etsy, pull in new orders, send them to Printful and push the tracking code back to the buyer.

  • Etsy Open API v3 with OAuth and PKCE
  • Printful catalogue, mockups and order routing
  • Orders, fulfilment and tracking in one flow

From design to delivered order

  1. Design

    Upload a design or generate one with AI, saved as a transparent 2K PNG per print area.

    • front
    • back
  2. Mockups

    Printful renders mockups per colour, and those become the product photos.

  3. Publish to Etsy

    Draft listing, images, inventory per variant, then activation.

  4. Order sync

    New and changed Etsy receipts polled every ten minutes, because Etsy has no order webhooks.

  5. Fulfil and track

    Paid orders go to Printful, and the shipment webhook sends the tracking code back to Etsy.

The print-on-demand loop in Salestreak.
What we can build

What we build on Etsy and Printful

The full loop, or just the part you need: publishing, order sync, print on demand or tracking.

Etsy shop connection

OAuth 2.0 with PKCE as Etsy requires, the right scopes for listings and transactions, and tokens refreshed before a sync starts.

Listings with variants

Products published as one Etsy listing with up to two variation properties, one offering per combination and the SKU on each offering.

Order sync

Etsy receipts fetched from the last cursor and upserted by receipt id, so running a sync again never duplicates an order.

Printful catalogue and designs

T-shirts from Printful's catalogue with print areas, regional availability and printfiles, and designs placed per print area.

Mockups as product photos

Printful's mockup generator called asynchronously, mockups downloaded straight away and reused as packshots for every channel.

Fulfilment and tracking

Orders sent to Printful with your own order id for idempotency, optionally confirmed automatically, with tracking pushed back to Etsy.

Proof, not promises

Built into our own selling platform

Salestreak, our selling workspace for online sellers, has both integrations built in. Sellers connect their Etsy shop and their Printful store through OAuth, design a T-shirt, get mockups as product photos and publish to Etsy. Orders come back into one list, and paid print-on-demand orders go to Printful.

Salestreak launched in 2026 and is still early, so we built both integrations closely on the documented APIs and covered them with automated tests. Printify and Gelato are on the list, not built.

  • Printful tokens refreshed every 15 minutes under a row lock, because Printful rotates the refresh token
  • Printful's unsigned webhooks protected with a secret token in the webhook URL
  • Orders paid by bank transfer only sent to production once the payment has arrived
  • Older Etsy connections without the tracking scope skip that step instead of failing the order
  • Every Etsy publish logged as a sync run, with one record per variant to match order lines later

How one product maps onto Etsy

  1. Product

    One product in the catalogue, with options such as size and colour.

  2. Listing

    One Etsy listing per product, with up to two variation properties named after the options.

  3. Offerings

    One offering per combination of options, each with its own price, quantity and SKU.

  4. Order lines

    The Etsy ids of every variant are stored, so incoming receipts match the right variant.

Why the order sync can match every Etsy receipt line to a variant.
between Etsy order syncs
10 min
between Printful token refreshes
15 min
transparent PNG per print area
2K
lifetime of a Printful access token, refreshed automatically
1 h
Who it's for

Who we build this for

Print-on-demand sellers

Design once, publish to Etsy and let paid orders flow to production without copying addresses by hand.

Etsy sellers growing beyond one shop

Listings, variants and orders managed from your own system, with Etsy as one of your sales channels.

Commerce platforms and SaaS

Offer Etsy publishing or print on demand inside your own product, under your own brand.

Creators and brands with merchandise

Merch with mockups as product photos and orders that ship without manual steps.

How it works

How we build an Etsy or Printful integration

Every marketplace and supplier has its own data model. Mapping them correctly is most of the work.

  1. 1

    Map your products to theirs

    Options, variants, SKUs and print areas mapped onto Etsy listings and Printful catalogue variants.

  2. 2

    Register the apps

    Etsy and Printful developer apps with exactly the redirect URLs and scopes they require.

  3. 3

    Build connect and refresh

    OAuth flows, encrypted tokens and refresh jobs that handle token rotation safely.

  4. 4

    Build publishing and syncing

    Listings, images and inventory out; receipts in, upserted so a sync can safely run again.

  5. 5

    Route and track orders

    Paid orders to production, then shipments and tracking back to the marketplace and the buyer.

  6. 6

    Test with real shops

    A careful first publish and first order per shop, checked by hand before automation takes over.

APIs and tooling

The Etsy Open API v3 and the Printful API, connected from a Rails application with background jobs, encrypted credentials and image processing.

  • Etsy Open API v3
  • Printful API
  • OAuth 2.0
  • PKCE
  • Webhooks
  • Ruby on Rails
  • Solid Queue
  • libvips
  • PostgreSQL
Cost & timeline

What does an Etsy or Printful integration cost?

It depends on how much of the loop you need. These factors decide the estimate:

Which direction
Publishing listings only, or also importing orders and pushing tracking back.
Product complexity
Simple products are quick; variants, print areas and several colours need more mapping.
Print on demand
Designs, mockups and automatic order routing add a second integration with its own edge cases.
Number of channels
Etsy alone, or Etsy alongside your own webshop and other marketplaces.
Existing listings
Starting fresh is simpler than matching listings and orders that already exist.
FAQ

Questions about Etsy and Printful integrations

How much does an Etsy API integration cost?

It depends on whether you only publish listings or also sync orders and tracking, how complex your products are and whether print on demand is involved. After a free intro call you get a written scope and estimate.

How long does it take to build an Etsy or Printful integration?

Publishing listings is a smaller project than the full loop with orders, production and tracking. The estimate after the intro call includes a timeline per phase.

Does Etsy have webhooks for new orders?

No, so orders are polled. Every ten minutes we ask Etsy for receipts that changed since the last sync, and we update orders by receipt id, so a repeated sync never creates duplicates.

Can Printful orders be submitted automatically?

Yes, if you want that. Paid orders whose lines all map to a Printful product with a ready design can go through automatically, or wait for a click on the order page.

Can you integrate Printify, Gelato or other suppliers?

We haven't built those yet. Printful came first because its API covers the whole loop, including mockups. Other suppliers would follow the same pattern.

Can I also sell through my own webshop?

Yes. In Salestreak the same products sell on Etsy and in the seller's own webshop with a Stripe checkout, and orders from both land in one list.

Selling on Etsy or with print on demand?

Tell us what you sell, where, and how orders are fulfilled today. You'll get an honest view on what to connect and what it would take.

martin@balk.dev

Typically a reply within one business day.

Useful to mention

  • What you want to build, in a few sentences
  • Who is going to use it
  • Any deadline or launch date
  • Tools and systems it should connect to