Printago API
POST /v1/customizer/designs/simulate-order

Simulate a customer order for a customizer design

Synthesise a real Order + OrderItem from an already-submitted customizer design, skipping Shopify entirely. The created order is `source: 'manual'` with a `note` line identifying it as a simulator artefact. The print pipeline is force-triggered regardless of the store's autoPrint setting so the full chain (design → reconciliation → PrintJob → builder) runs end-to-end.

Requires: customizer.manage

Request Body

RequestBody
configIdoptional
string
pattern: ^[a-z0-9]{24}$
designIdrequired
string
pattern: ^[a-z0-9]{24}$
quantityoptional
number
skuIdoptional
string
pattern: ^[a-z0-9]{24}$

Example Request

application/json
{
  "designId": "string",
  "configId": "string",
  "skuId": "string",
  "quantity": 1
}

Response Schema

Response
designIdrequired
string
pattern: ^[a-z0-9]{24}$
orderIdrequired
string
pattern: ^[a-z0-9]{24}$
orderItemIdrequired
string
pattern: ^[a-z0-9]{24}$
orderNumberrequired
string

Example Response

201 OK — application/json
{
  "orderId": "string",
  "orderItemId": "string",
  "orderNumber": "string",
  "designId": "string"
}