Sign in
Orders

Submit a Printify Express order

Submit a Printify Express order

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

Request body

external_idstring nullable
labelstring nullable
shipping_methodinteger 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": 3,
  "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

Example response

{
  "data": [
    {
      "type": "order",
      "id": "5a96f649b2439217d070f508",
      "attributes": {
        "app_order_id": "215014.44",
        "fulfilment_type": "express",
        "line_items": [
          {
            "product_id": "5b05842f3921c9547531758d",
            "quantity": 1,
            "variant_id": 12359,
            "print_provider_id": 5,
            "cost": 2200,
            "shipping_cost": 799,
            "status": "pending",
            "metadata": {
              "title": "18K gold plated Necklace",
              "price": 2200,
              "variant_label": "Golden indigocoin",
              "sku": "168699843",
              "country": "United States",
              "external_id": "line-item-abc-001"
            },
            "sent_to_production_at": "2023-10-18 13:24:28+00:00"
          }
        ]
      }
    }
  ]
}

Changes

Changed in 1 of the 2 revisions of this API.2

  • ed97a9d13fe72See the full diff
    • ○

      added the new optional request property line_items/items/personalisation

      new-optional-request-property

    • ○

      added the new optional request property line_items/items/personalisation_instructions

      new-optional-request-property