MADE TO ORDER | API INTEGRATION GUIDE

Ready2HangArt

API INTEGRATION GUIDE
Automating Fulfillment via Order Desk

For: Retail Partner

From: Ready2HangArt Team

Goal: Route your orders automatically to Ready2HangArt for production and shipping - eliminating manual Excel file transfers.

Welcome! This guide will walk you through setting up an automated print-on-demand fulfillment workflow. By connecting your Order Desk account to the Ready2HangArt API, your orders will sync seamlessly, ensuring faster production turnaround times and automated tracking updates.

1. INTEGRATION CREDENTIALS & DETAILS

To establish the connection, Ready2HangArt will provide you with a unique, secure connection token (a private API key). Please handle this token as you would a password and keep it completely confidential.

Provider Ready2HangArt
API Base URL https://portal.ready2hangart.com/api/pod
Authentication Type Token passed in the X-AUTH-TOKEN header
Note: Your private token will be delivered to you through a secure channel as soon as the configuration is finalized on our end.

2. STEP-BY-STEP CONFIGURATION IN ORDER DESK

Please follow these instructions within your Order Desk dashboard to activate the integration:

  1. Log in to your primary Order Desk account.
  2. Navigate to the left-hand menu and select Integrations (or Manage Integrations).
  3. Add or enable a new Custom / Generic Fulfillment (API) integration for Ready2HangArt. If a dedicated "Ready2HangArt" option is not visible, Order Desk's standard "Print on Demand / Custom Fulfillment" connector can be utilized. Order Desk Support can quickly assist in setting up a custom API endpoint if needed.
  4. In the setup fields, carefully enter the following values:
    • Endpoint / Base URL: https://portal.ready2hangart.com/api/pod
    • Token / API Key: Enter the unique X-AUTH-TOKEN value provided by our team.
  5. Assign Ready2HangArt as the primary provider for all corresponding product categories that we manufacture for you (including canvas, framed canvas, framed prints, and matted prints).
  6. Verify that each of these products has its print file (artwork URL) explicitly configured inside Order Desk. This print file is essential for production and is automatically transmitted to us with every order payload.

3. THE AUTOMATED ORDER & SHIPMENT WORKFLOW

Once the integration is active, the entire lifecycle of an order runs fully autonomously behind the scenes:

Step 1: A customer purchases a mapped product directly on your retail storefront.
Step 2: Order Desk captures the sale and automatically transmits the order payload to Ready2HangArt (including the shipping address, specific item data, quantities, and the high-resolution artwork print URL).
Step 3: The order is ingested into the Ready2HangArt Made to Order Portal, routing it instantly to our manufacturing floor for printing, framing, and assembly.
Step 4: As our team accepts, manufactures, and dispatches the item, Order Desk is automatically notified in real time with live status updates and carrier tracking numbers.

Result: No manual data entry, no spreadsheet uploads, and no email coordination required per order.

4. FINAL PRE-LIVE VERIFICATION STEPS

Before officially turning on live order routing for your customers, we require completing the following coordination tasks:

  • Product SKU Mapping: We must align and confirm the exact mapping configuration to ensure your storefront SKUs match the correct Ready2HangArt product specifications, dimensions, and frame styles.
  • End-to-End Test Order: We will process an initial test order together to verify that payloads flow correctly from your cart, through Order Desk, into our portal, and back with tracking data.