Sign in
Orders

Submit an order

Submit an order

post/v1/shops/{shop_id}/orders.json

Request body

external_idstring nullable
labelstring nullable
shipping_methodinteger nullable
is_printify_expressboolean nullable
is_economy_shippingboolean nullable
send_shipping_notificationboolean nullable

Example request

{
  "external_id": "2750e210-39bb-11e9-a503-452618153e4a",
  "label": "00012",
  "line_items": [
    {
      "product_id": "5bfd0b66a342bcc9b5563216",
      "variant_id": 17887,
      "quantity": 1,
      "external_id": "line-item-abc-001",
      "personalisation": {
        "personalisation_strategy": "pstudio_pre_order_headless",
        "personalisation_instructions": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
        "buyer_request": "Please use John as first name",
        "layers": [
          {
            "personalisation_id": "123",
            "name": "front",
            "layer_type": "text",
            "text_input": "John",
            "image_id": "789"
          }
        ],
        "personalisation_buyer_confirmation": {
          "approved": true,
          "source": "storefront",
          "date": "2017-04-18T13:24:28+00:00",
          "ip_address": "192.168.1.100",
          "user_agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/126.0.0.0 Safari/537.36"
        }
      },
      "personalisation_instructions": "Please add text"
    }
  ],
  "shipping_method": 1,
  "address_to": {
    "first_name": "Jane",
    "last_name": "Smith",
    "address1": "ExampleBaan 121",
    "address2": "Apt 4B",
    "city": "Retie",
    "zip": "2470",
    "email": "example@msn.com",
    "phone": "0574 69 21 90",
    "country": "BE",
    "company": "MSN"
  }
}

Response

Successful operation

idstring

Example response

{
  "id": "5a96f649b2439217d070f507"
}

Changes