> 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/imagine-your-photos-integration.md). # Imagine Your Photos Integration Order Desk can import orders from your shopping cart(s), sync in your print details and then automatically send them on to [Imagine Your Photos](https://www.iypstore.com/default.aspx?PK=19941641-521e-4fbb-a722-6232873a2a89) for fulfillment. When orders are shipped, the tracking details will be sent back to Order Desk automatically. ### Setup To connect to Imagine Your Photos, click on the **Manage Integrations** link under the **Integrations** menu in the left sidebar, and under the **Print on Demand** tab find and enable Imagine Your Photos. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FTgcqIfi4KdAu5dt4j0z7%2Flegacy-549eefb7386c7934ef1c.gif?alt=media) Once enabled, give your webhook URL to your Imagine Your Photos account rep, then enter your Imagine Your Photos credentials and click to connect. Both Production and Staging environments are supported. ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FF7WkDRObMzFKCKJnUtef%2Flegacy-87b844e0eb27befd5b62.png?alt=media) To find your Imagine Your Photos credentials, please contact your rep from Imagine Your Photos. **Order Desk support is not able to help with finding or resetting your Imagine Your Photos credentials**, as they are created and provided by Imagine Your Photos. ### Integration Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FAYyfGuqWNBwDsexAIYi6%2Flegacy-549509f96e1a80b0b445.png?alt=media) Once connected, you can set your preferences for this integration in the integration settings. #### After Import, Move To Choose the folder where orders should be moved to after they are successfully sent to Imagine Your Photos. You can choose the default Prepared folder for this, or create your own folders in your Store Settings. 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 Choose the folder where orders should be moved to as Imagine Your Photos sends tracking details back. #### Default Shipping Class Set the default shipping class for your orders. You can set a custom method and code on individual orders if necessary, details [below](#custom-shipping-options). #### Backup Email Set the email address Imagine Your Photos should use for any orders that don’t have one included. #### Notification URL This URL allows Imagine Your Photos to send tracking details back to Order Desk as they ship your orders. Please copy this URL and give it to Imagine Your Photos to apply to your account. #### Setup Redirects ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FHXIYlKVwBhQwmuWmW9vG%2Flegacy-f2674799a26b678ab653.png?alt=media) If you connect the same Imagine Your Photos account to more than one Order Desk store, you will need to setup some redirects so when the shipment info comes back from Imagine Your Photos, it will find its way to the right Order Desk store. In your primary store, where the first connection to Imagine Your Photos was made, you will see **Setup Redirects**. Click this link to open your Webhook Redirection List. Then, in your other Order Desk stores that are also connected to the same Imagine Your Photos account, find the Notification URL: ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2F5QXKGjTktEZ5AHIkYDtl%2Flegacy-e484da36e732e064ac12.png?alt=media) Copy this URL and paste it into the **Setup Redirects** field in your main store. Add one URL per line, making sure all notification URLs from your other Order Desk stores are included. #### Default Return Address Set your default return address for Imagine Your Photos 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 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 Imagine Your Photos 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. #### Product Settings ![](https://251457507-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAQOLMUJWMYtrpQ7Oxxca%2Fuploads%2FfmLXTXc1ItrJapWzP7me%2Flegacy-2b334d269b6e2bfa90a4.png?alt=media) For more information on what these product settings within the Imagine Your Photos 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%2Fy79a0t6FMvGmmhJn1Jt8%2Flegacy-23b01e8b7ed0252c5d4e.png?alt=media) If the shipping methods you set up in your shopping cart(s) don’t match the shipping method names Imagine Your Photos uses, they won’t know what methods you intend for them to use. When this happens, the [default mail class applied above](#integration-settings) will be used instead for all of your orders. To tell Imagine Your Photos what methods you want them to use, you will need to match your method names to theirs. This can be done in the shipping class match section. For detailed instructions on setting this up, please read through the [shipping class match](/guided-walkthroughs/shipping-fulfillment-and-returns/how-to-set-up-shipping-class-matches.md) guide. ### Sending Orders to Imagine Your Photos Getting your orders ready to send to Imagine Your Photos 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. #### Preparing Your Items The following details can be submitted for an order as either checkout data or order metadata. | Field Name | Field Description | | -------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | PackingSlip | URL for the PDF to be included as the packing slip with the order. Details [here](/guided-walkthroughs/templates-emails-and-order-documents/how-to-create-pdf-files-for-order-documents.md). | | Insert | Must be pre-approved by Imagine Your Photos. | | ShipToMethod | If you have a custom ship to method | | ShipToCode | If you have a custom ship to code | | ShippingLabel | Use to set order shipping label if required. | | TrackingNumber | Use to set a tracking number if required. | If you are unfamiliar with checkout data, see the [How to Work with Checkout Data](/guided-walkthroughs/orders-and-folders/how-to-work-with-checkout-data.md) guide. #### Preparing Your Items The following fields can be set as variations or item metadata for each order item. | Field Name | Field Description | | ----------------------------- | --------------------------------------------------------------------- | | print\_sku | **Required.** Imagine Your Photos product code for the item. | | print\_url | **Required.** URL of the artwork file. | | imagineyourphotos\_print\_url | Optional. Custom print\_url that only applies to Imagine Your Photos. | #### Custom Shipping Options For custom shipping, set **ShippingCarrier** and **ShippingMethod** fields in the checkout data of your orders to override the defaults you selected in the [integration settings](#integration-settings). Valid carriers are USPS, FEDEX, UPS, USPSMailInnovations, DHL, DHL Global Mail, and DHL Global Mail International. --- # 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/imagine-your-photos-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.