Orders

Submit and manage orders

Create order

post

This API endpoint creates an order and returns it.

Authorizations

bearerAuth

AuthorizationstringRequired

Bearer authentication header of the form Bearer <token>.

Body

application/json

reference_order_idstringOptional

External order id in your system.

Example: #1001

test_orderbooleanOptional

Flag to create a test order (no production fulfillment).

Example: false

shipment_notification_urlstringRequired

A webhook callback URL for shipment updates. If provided, the print provider will send an HTTP POST request to this URL when the order ships, including tracking details (e.g. tracking number, tracking url, tracking company). This allows your system to automatically receive delivery updates without polling the API.

Example: https://api.teeinblue.com/api/webhook/print-provider?order-token=7d1e0f01ff56119101046f4f27a88412

Responses

201

Order created

application/json

400

Bad Request

application/json

401

Unauthorized

application/json

422

Unprocessable Entity (validation error)

post

/orders

HTTPcURLJavaScriptPython

POST /v1/orders HTTP/1.1
Host: example.com
Authorization: Bearer YOUR_SECRET_TOKEN
Content-Type: application/json
Accept: */*
Content-Length: 705

{
  "reference_order_id": "#1001",
  "test_order": false,
  "shipment_notification_url": "https://api.teeinblue.com/api/webhook/print-provider?order-token=7d1e0f01ff56119101046f4f27a88412",
  "shipping_address": {
    "zip": "60089",
    "city": "Buffalo Grove",
    "phone": "0123456789",
    "company": null,
    "country": "France",
    "address1": "999 Rue Lucie Aubrac",
    "address2": null,
    "province": null,
    "last_name": "John",
    "first_name": "Carry",
    "country_code": "FR",
    "province_code": null
  },
  "line_items": [
    {
      "quantity": 1,
      "print_areas": [
        {
          "key": "front",
          "url": "https://front-design.png"
        },
        {
          "key": "back",
          "url": "https://back-design.png"
        }
      ],
      "variant_sku": "2342"
    },
    {
      "quantity": 1,
      "print_areas": [
        {
          "key": "default",
          "url": "https://default-design.png"
        }
      ],
      "variant_sku": "2342"
    }
  ]
}

{
  "id": "ord_123456",
  "status": "created",
  "reference_order_id": "#1001"
}