Turbine Integration


Integration Settings
Product Settings
Custom Details for Turbine


Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to Turbine for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk and back to your shopping cart if your store is set up for it.

This guide explains how to set up and use the Turbine integration.


To connect to Turbine, click on the Manage Integrations link under the Integrations menu in the left sidebar, and under the Print on Demand tab find and enable Turbine.

Once enabled, set up the provided webhook URL in your Turbine account, then enter your API details and connect.

Integration Settings

Once connected, you'll have some shipment and integration settings to adjust per your preferences.

After Import, Move To

Select the folder you want orders to be moved into after they are successfully sent to Turbine.

You can use one of the default folders already in your store or create your own. Read the Working with Folders guide for more information.

After Shipment, Move To

Select the folder you want orders to be moved into after Turbine sends shipment details back to Order Desk.

If Canceled, Move To

Select the folder you want orders to be moved to if they are canceled at Turbine.

Default Shipping Carrier

Choose the shipping carrier you want Turbine to use for your orders.

Default Shipping Method

Choose the shipping method you want Turbine to use for your orders.

Notification URL

Give this notification URL to your Turbine contact and ask them to send shipment notifications to it. This is how they will connect back to Order Desk to send tracking details as they ship your orders.

This URL does not change between staging and production environments.

Setup Redirects

If you have Turbine connected to more than one Order Desk store for the same account, instead of adding the notification URL for each connection to Turbine, add any additional notification URLs from other connections to your primary account. Add one URL per line.

When Turbine ships your items, these redirects will help the shipments find their way back into the Order Desk store the orders came from.

Send Customer Email Address to Turbine

Select this setting if you want customer email addresses to be included with the order details that are sent to Turbine.

Garments Will Be Provided

Select this setting if you will be providing the garments for Turbine to use for printing.

Default Return Address

Set the default return address that Turbine should use on your shipments.

If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and then use a rule to set the return address to specific orders. If a return address is not added to the order, the default address set here in the Turbine settings will be used.

For information on adding additional return addresses and applying them to specific orders with a rule, read the Store Settings guide.

Product Settings

For more information on what these product settings within the Turbine integration are for, please refer to the Print on Demand Product Settings guide.

Custom Details for Turbine

Initially, getting your orders ready to send to Turbine is going to take some time before everything is in place for it to happen automatically. For detailed instructions on how to use Order Desk with your print on demand orders, please take a few moments to read the print on demand fulfillment guide.

Custom Order Details

The following details can be submitted for an order as either checkout data or order metadata.

Field Name Field Description
InsertImage The URL for a custom insert image.
ShippingProvider UPS, FedEx, or DHL. If not provided, the default setting will be used.
ShippingMethod If not provided, the default setting will be used.
GarmentsProvided TRUE or FALSE. If not provided, the default setting will be used.
OrderNotes Any notes that should be passed along with the order.
ProductionPriority Normal or Express. Defaults to Normal.
PackingSlip URL for the PDF to be included as the packing slip with the order. Details here.
TrackingNumber If sending a shipping label, please pass the tracking number on the label for customer service reasons
ShippingLabel Link to a shipping label you want to be used with the order
ReferenceNumber Set an internal reference identifier for the order.

If you are unfamiliar with checkout data, see the How to Work with Checkout Data guide.

Custom Item Details

The following fields can be set as variations or item metadata for each item in an order. Replace _x with a number value if more than one artwork file will be sent for a single item (print_url_2, print_location_2, print_preview_2, etc.)

Field Name Field Description
print_sku Turbine's internal SKU for the item.
custom_tag_code_ x Use code given to you by Turbine if using a custom tag. Supports values 1 through 4 for multiple tag codes. Up to 12.
print_location_ x Default is unspecified. Start with 'F' or 'B' (front or back) and continue the descriptor as needed (i.e. Front Center, Back Bottom). Up to 12.
print_url_ x The URL for your artwork file. Google Drive links will not work with Turbine. Up to 12.
print_preview_ x The URL for the preview of your finished product. The "image" field will be used if nothing is entered. Up to 12.
print_underbase_ x TRUE or FALSE. Indicate whether a white underbase layer should be applied before the art. Default is FALSE. Up to 12.
print_xoffset_ x
Integer in millimeters (mm) to place the artwork horizontally from the origin point of the printer. Up to 12.
print_yoffset_ x Integer in millimeters (mm) to place the artwork vertically from the origin point of the printer. Up to 12.
print_width_ x Floating number width in inches (in) to print the artwork. Up to 12.
print_height_ x Floating number height in inches (in) to print the artwork. Up to 12.
custom_tag_type_ x Apply a custom tag to the item. Supports hang tag and sticker. Up to 12.
custom_tag_image_ x Preview image URL. Up to 12.
custom_tag_print_ x TRUE or FALSE. Specify whether you would like the tag printed and affixed to the garment after production. Up to 12.
decoration_type Sets the decoration type with a value of either dtf or dtg or none. Please note, this should be set to none for items that are pre-saved and only require the print_sku to be sent.

Still need help? Contact Us Contact Us