Creating Print-On-Demand order items

How to describe a POD order item in an order
Updated 2 months ago

When creating a print-on-demand order item, the caller needs to communicate both what item blank is being used as well as what decoration is being applied. Each of these can be done in different ways depending on what the calling system can support.

Item Blank

For the blank, either a GTIN (Global Trade Item Number) or the Fulfill Engine SKU id must be provided.  These values should be set via the order item group's sku or gtin property respectively, but only one should be supplied.

Ask your account representative for a catalog of SKUs / GTINs supported.

Item Decoration

The decoration information is provided inline via the designData property, which contains an array property called artwork.  Each artwork represents a decoration that should be applied to the blank product.


The most important field in the artwork is originalFileUrl, which should be a URL to the image to be printed. In addition to this field, the API supports passing in an array of mockups which can provide URLs to images of the artwork on the product. This can provide helpful verification to the manufacturing team for what the decorated product should look like.

Artwork placement

While the mockup images are helpful, artwork placement information is critical. It in is required for the decorator to place the item properly on the product.

The system supports several different approaches to conveying the placement information, depending on what may be available in the calling system. Read more about artwork placement here.

Decoration methods

The last key piece in describing the decoration is the method being used.

  • printingMethod - Required. Allowed values: dtf, dtg, embroidery, engraving
If using embroidery, additional details must be provided. Learn more here.
Did this answer your question?