Create an order
POST/v1/orders
Creates an order and returns it.
Send exactly one of client (a customer you have not saved yet) or client_id (an existing client of your company). Use address_id for DELIVERY orders and table_id for TABLE orders.
The order starts as PENDING; move it forward with PATCH /v1/orders/{id}/status.
Requires an Idempotency-Key header; replaying the same key with the same body returns the original result.
Required scope: orders:write
Request
Responses
- 201
- 401
- 403
- 404
- 422
The created order.
Unauthenticated — the request is missing a credential, or the Bearer token / API key is invalid, expired, or revoked.
Insufficient scope — the credential is authenticated but lacks a scope the endpoint requires.
Not found — no resource matches the id in the path (or it belongs to a different company).
Validation failed — the request body failed schema validation. errors[] lists every offending field.