Printful tools
The 12 Printful operations your product runs on your customer's account through Connect. All of them use the same endpoint, POST /api/tools/{tool}/execute.
- List ordersGETLists the orders of the store with status, recipient, items, costs and shipments. Pages with offset and limit; paging.total in the response is the number of orders.
- Get orderGETReturns one order with its status, recipient, items, costs and the shipments with carrier and tracking number.
- Create orderPOSTCreates an order as a draft and returns it with the costs Printful calculated. Nothing is charged until Confirm order. recipient and items are required, and print files are downloaded from public URLs.
- Update orderPUTChanges an order that was not submitted for fulfillment yet and returns it. Send only the fields that change; sending items replaces the item list. Nothing is charged until Confirm order.
- Confirm orderPOSTSubmits a draft order for fulfillment and returns it. Printful charges the billing method of the store owner at this moment; a pending order can still be canceled with Cancel order.
- Cancel orderDELETECancels a draft or pending order and returns it. A charged amount goes back to the card of the store owner. Orders in review, in process or already shipped cannot be canceled.
- Calculate shipping ratesPOSTReturns the shipping methods for a list of items and a destination, with rate, currency and delivery estimate. The id of a method goes in shipping of Create order and Update order. Call it right before ordering, because rates change.
- List catalog productsGETLists the blank products of the Printful catalog, such as t-shirts, mugs and posters, with id, title, type, brand and main_category_id. Get catalog product returns the variants of one of them.
- Get catalog productGETReturns a catalog product and its variants. Each variant has the id that orders and shipping rates take as variant_id, with size, color, price and stock; the product lists the print file placements (files) and options it accepts.
- List store productsGETLists the products of a store created in Printful for manual orders and the API, with id, external_id, name and how many variants each has. Get store product returns the variants.
- Get store productGETReturns a store product and its variants. The id of each variant is the sync_variant_id of Create order, and its variant_id is the catalog variant behind it.
- Get statisticsGETReturns sales, costs and profit statistics of the store for a period of up to 6 months, one entry per report type in result.store_statistics.
See Connect applied to your product.
Try it for 15 days with no card, or walk our team through your use case.
