Create Order

POST

https://v3.mangoteeprints.com/api/public/v1/orders

Last modified:2025-12-04 10:07:57

Create new order.

Required permission: create:orders

Logic identical to V3, only override user_id from API key.

Request

Header Params

Body Params application/json

Example

{
    "address_line_1": "123 Main Street",
    "address_line_2": "Suite 100",
    "city": "New York",
    "country": "United States",
    "email": "johndoe@example.com",
    "facility": "TX",
    "first_name": "John",
    "items": [
        {
            "preview_files": [
                {
                    "key": "front",
                    "url": "https://example.com/preview_file_1"
                },
                {
                    "key": "back",
                    "url": "https://example.com/preview_file_2"
                }
            ],
            "print_files": [
                {
                    "key": "front",
                    "url": "https://example.com/print_file_1"
                }
            ],
            "production_config": "default",
            "quantity": 2,
            "sku": "SKU001"
        }
    ],
    "inserts": [
        {
            "name": "packing_slip",
            "size": "8.5x11",
            "url": "https://example.com/packing_slip.pdf"
        }
    ],
    "label_url": "https://example.com/label/priority-order.pdf",
    "last_name": "Doe",
    "note": "Please deliver during business hours",
    "order_id": "ORD002",
    "phone": "+1-555-123-4567",
    "seller": "SELLER001",
    "shipping_method": "standard",
    "speed_type": "rush",
    "state": "NY",
    "zip": "10001"
}

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request POST 'https://v3.mangoteeprints.com/api/public/v1/orders' \
--header 'X-API-Key;' \
--header 'Content-Type: application/json' \
--data-raw '{
    "address_line_1": "123 Main Street",
    "address_line_2": "Suite 100",
    "city": "New York",
    "country": "United States",
    "email": "johndoe@example.com",
    "facility": "TX",
    "first_name": "John",
    "items": [
        {
            "preview_files": [
                {
                    "key": "front",
                    "url": "https://example.com/preview_file_1"
                },
                {
                    "key": "back",
                    "url": "https://example.com/preview_file_2"
                }
            ],
            "print_files": [
                {
                    "key": "front",
                    "url": "https://example.com/print_file_1"
                }
            ],
            "production_config": "default",
            "quantity": 2,
            "sku": "SKU001"
        }
    ],
    "inserts": [
        {
            "name": "packing_slip",
            "size": "8.5x11",
            "url": "https://example.com/packing_slip.pdf"
        }
    ],
    "label_url": "https://example.com/label/priority-order.pdf",
    "last_name": "Doe",
    "note": "Please deliver during business hours",
    "order_id": "ORD002",
    "phone": "+1-555-123-4567",
    "seller": "SELLER001",
    "shipping_method": "standard",
    "speed_type": "rush",
    "state": "NY",
    "zip": "10001"
}'

Responses

🟢200Successful Response

application/json

Body

Example

{
    "code": "ORDER_CREATED",
    "data": {
        "address_line_1": "123 Main Street",
        "address_line_2": "Suite 100",
        "box_fee": 0,
        "city": "New York",
        "country": "US",
        "created_at": "2025-08-20T16:04:42.675869",
        "created_by": "3f432ee6-2214-4732-a1ed-2462c38c76fa",
        "discount": 0,
        "email": "johndoe@example.com",
        "facility": "TX",
        "first_name": "John",
        "id": "2bf824c3-7f14-41a1-a523-0972c18bd119",
        "items": [
            {
                "base_cost": 4.7,
                "color": "ANTIQUE IRISH GREEN",
                "inserts": [
                    {
                        "name": "packing_slip",
                        "size": "8.5x11",
                        "url": "https://example.com/packing_slip.pdf"
                    }
                ],
                "item_id": "YMVU6MXKH69584EPW8TF7STM",
                "preview_files": [
                    {
                        "key": "mockup_front_url",
                        "url": "https://example.com/preview_file_1"
                    },
                    {
                        "key": "mockup_back_url",
                        "url": "https://example.com/preview_file_2"
                    }
                ],
                "print_files": [
                    {
                        "key": "front",
                        "url": "https://drive.google.com/file/d/1uN5z1dPiDUOW0ymN3F81iXeE5CIgfGt8/view?usp=drive_link"
                    }
                ],
                "product_name": "Unisex T-shirt | Gildan 5000",
                "quantity": 2,
                "size": "M",
                "sku": "G05000AIG000M"
            }
        ],
        "label_url": "https://example.com/label/priority-order.pdf",
        "last_name": "Doe",
        "note": "Please deliver during business hours",
        "order_id": "ORD005",
        "payment_status": "pending",
        "phone": "+1-555-123-4567",
        "production_line_id": "8d9d7894-3908-4938-aa26-96f803c025ea",
        "production_status": "pending",
        "re_placed": false,
        "seller": "SELLER001",
        "shipping_fee": 6.9,
        "shipping_method": "standard",
        "state": "NY",
        "status": "new_order",
        "subtotal": 10.78,
        "tax": 0,
        "total": 17.68,
        "updated_at": "2025-08-20T16:04:42.675869",
        "user_id": "3f432ee6-2214-4732-a1ed-2462c38c76fa",
        "zip": "10001"
    },
    "message": "Tạo order thành công",
    "request_id": "7f733dec-fc79-4943-9f21-31d5495bb025",
    "status": true,
    "timestamp": "2025-08-20T16:04:44.290492"
}

🟠422Validation Error

Modified at 2025-12-04 10:07:57

Get Product Variations

List Orders