---
title: "Create Order"
method: POST
path: "/ordering/api/orders"
tags: ["Bamboo Ordering"]
---

# Create Order

`POST /ordering/api/orders`

## Headers

- `Idempotency-Key` string, nullable
- `authorization` string, nullable

## Request body

- OrderIn
  - `branch_id` integer, required
  - `fulfillment` string
  - `lat` number, nullable
  - `lng` number, nullable
  - `items` object[], required
  - `customer_name` string, required
  - `customer_phone` string, required
  - `address` object, nullable
  - `payment_method` string
  - `notes` string, nullable
  - `expected_total` number, nullable

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-15** `89d32f99b303` — 3 breaking, 6 warning, 2 info
  - the `items` request property's minItems was increased to `1`
  - the `customer_name` request property's minLength was increased from `0` to `1`
  - added the pattern `^(delivery|pickup)$` to the request property `fulfillment`
  - the `customer_name` request property's maxLength was set to `100`
  - …7 more
- **2026-09-14** `a7c354500751` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/bamboome/apis/contact-sync-api/changes/ordering/api/orders/post.md)

---

[API](https://skmtc.dev/bamboome/apis/contact-sync-api.md) · [All operations](https://skmtc.dev/bamboome/apis/contact-sync-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bamboome/apis/contact-sync-api/revisions/ea1096d3e074?raw)