> For the complete documentation index, see [llms.txt](https://help.orderdesk.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.orderdesk.com/integration-setup-guides/print-on-demand/spoke-custom-integration.md). # Spoke Custom Integration Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to [Spoke Custom](http://www.spokecustom.com/) 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. ### Setup To enable the integration, click on **Manage Integrations** in the left sidebar. Under the **Print on Demand** tab, find and enable the Spoke Custom integration. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FsXO8zffnHGXPBESY5Sc0%2Flegacy-399705ed29ed1bdd038c.gif?alt=media) Once enabled, send your unique webhook url to your Spoke Custom contact, then enter the credentials provided to you by Spoke Custom and click **Connect**. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FhEYPabh0yrdS92b6UQD0%2Flegacy-09a2ac524242b9739f18.png?alt=media) To find your Spoke Custom credentials, please contact your rep from Spoke Custom. **Order Desk support is not able to help with finding or resetting your Spoke Custom credentials**, as they are created and provided by Spoke Custom. ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FpfQol29sLP91xuXfQyWq%2Flegacy-ee532577fc4f5447d4ea.png?alt=media) #### Default Shipping Classes Choose the shipping classes you want Spoke Custom to use for your domestic and international orders. If you need to apply specific methods for certain orders, match your method names to Spoke Custom’s names in the [Shipping Class Match section](#shipping-class-match) below. #### Shipping Account Enter the shipping account number you would like Spoke Custom to use for your orders. #### Logo URL Link to your logo to be added to the packing slip. Must be a JPG file. #### Packing Slip Message Add a message to be displayed on the packing slip for your customers. #### After Import, Move To Select the folder you want orders to be moved into after they are successfully sent to Spoke Custom. You can use one of the default folders already in your store or create your own. Read the [Working with Folders](/start-here/getting-started-series/quick-start-overview.md#working-with-folders) guide for more information. #### After Shipment, Move To Select the folder you want orders to be moved into as Spoke Custom sends shipments back to Order Desk. #### Notification URL Give this notification URL to Spoke Custom. They will use it to connect to your Order Desk account and send shipment details back to your orders automatically. #### Default Shipment Return Address Set your default return address for Spoke Custom to use on your order shipments. If you need to customize the return address for certain orders, you can save different return addresses to your Store Settings and use a rule to set the return address on specific orders. If a return address is not added to the order, the default address set here in the Spoke Custom settings will be used. For information on adding additional return addresses and applying them to specific orders with a rule, read the [Store Settings](/guided-walkthroughs/using-order-desk/manage-store-settings.md#return-addresses) guide. If the order does not have a phone number on it, the Shipper Phone Number is used. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FMWkNhv884fjSXXAL4j5L%2Flegacy-4b446ea853038357b302.png?alt=media) For more information on what these product settings within the Spoke Custom integration are for, please refer to the [Print on Demand Product Settings](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-integration-product-settings.md) guide. #### Shipping Class Match ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F7j7PZ28AnCZiAl2DrRlh%2Flegacy-807af908cd4b58d2cae2.png?alt=media) The shipping methods that you have set up in your shopping cart(s) may not match the methods that Spoke Custom uses. To make sure your shipping preferences are sent through to Spoke Custom with each order, match your methods to theirs in the shipping class match feature. To learn in more detail about how to set up your shipping class matches, see the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide. ### Sending Orders to Spoke Custom Getting your orders ready to send to Spoke Custom will take some set up time. For a detailed walkthrough of how to use Order Desk with your Print on Demand orders, please read through our [Print on Demand Fulfillment](/guided-walkthroughs/print-on-demand-walkthrough/print-on-demand-fulfillment.md) guide. #### Item Details The following fields can be set as variations or item metadata for each item in an order. | Field Name | Field Description | | -------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | print\_sku | **Required.** Spoke Custom’s product code. | | print\_url | **Required** unless print\_image\_type is set to “embroidery”. Link to your artwork file. | | print\_preview | The location of the artwork preview. | | print\_description | Describes the product being printed. | | print\_image\_type | Default image type is JPG. Set image file type if different, such as PNG. Google Drive files using com/uc will automatically have JPG applied. Embroidery is also supported. | | print\_image\_text | **Required** when print\_image\_type is set to “embroidery”. Sets the embroidery text. | | print\_image\_font | **Required** when print\_image\_type is set to “embroidery”. Sets the embroidery font. | | print\_image\_color | **Required** when print\_image\_type is set to “embroidery”. Sets the embroidery color. | | preview\_image\_type | Default image type is JPG. Set image file type if different, such as PNG. Google Drive files using com/uc will automatically have JPG applied. | #### Order Details Spoke Custom only accepts numeric order numbers. If your orders have any non-numeric values, they will be removed from the order number before submitting to Spoke Custom. The following fields can be set as checkout data or order metadata to add or change the details that are sent to Spoke Custom about the order. | Field Name | Field Description | | --------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | ShippingAccount | Shipping account to be used for the order. If not set, the [default shipping class](#integration-settings) will be used. The shipping account needs to match the shipping class that is used for the order or Spoke Custom will not accept the order. | | PackingSlip | A URL for the PDF to be included as the packing slip on the order. Details [here](/guided-walkthroughs/templates-emails-and-order-documents/how-to-create-pdf-files-for-order-documents.md). | | PONumber | Add your own PO number to an order. | | print\_description | This field is passed into the CaseDescription field at Spoke Custom. If left empty, the item name will be sent. | | IOSS | Send the IOSS number that you want to be used on the order to Spoke Custom. If not set, the default IOSS number from the Store Settings will be used instead. | | spokecustom\_key | Use this field to pass an API key that will override the default stored in Order Desk. | | spokecustom\_customer\_name | Use this field to pass an API name that will override the default stored in Order Desk. | If you are unfamiliar with checkout data, please read the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide. ### Related Articles * Print On Demand Fulfillment * Print on Demand Order Syncing --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.orderdesk.com/integration-setup-guides/print-on-demand/spoke-custom-integration.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.