Order Submit API Overview

Getting Started

Our Order Submit API lets you order many of our products programatically. We receive, produce and ship thousands of orders via our Order Submit API every day.

You'll need Order API credentials before you can access the API. Reach out with details on your project and the types of products you're looking for and we'll get you setup with what you need.

Sandbox environment

We have a sandbox environment available to use while you build your integration. You will need a different set of credentials for each environment.

Sandbox URL: https://sandbox.apps.whcc.com
Production URL: https://apps.whcc.com

All of the examples throughout this documentation points to the production URL.

All requests require the use of https.

The sandbox environment also lets you trigger webhooks on demand while you build your handler. See the Webhook Sandbox.

Basic Flow

  1. Make image assets accessible to WHCC by URI somewhere, such as Amazon S3. Optionally leverage signed URLs for additional security.

  2. Authenticate and get an access token for importing and submitting your order request against the correct WHCC account.

  3. Generate an order request as structured JSON defining your order based on our JSON product catalog.

  4. Import your JSON order request and sanity-check the order contents response.

  5. Submit your order for production using a ConfirmationID returned when importing your order request.

  6. Register to receive and then consume webhooks from WHCC as your order is processed and then shipped.

Looking for a way for your users to design and create the products themselves? Check out our Editor API for our rich, white-label product design and creation experiences.

What's Next

Get started with Authentication

Back to Top 👆
Get in Touch

Interested in integrating with WHCC? Tell us more about what you’re looking for and we’ll be in touch.