---
title: "Post Order"
method: POST
path: "/crm/orders"
tags: ["CRM Service Calls"]
---

# Post Order

`POST /crm/orders`

Create a new order.

At least one of `account_id` or `contact_id` is required.

**Request Body (OrderRequest):**

- **name** *(optional)*: Order name.
- **order_type** *(default: "sales")*: Values: sales, quote.
- **account_id** *(optional)*: FK to an account.
- **contact_id** *(optional)*: FK to a contact.
- **stage** *(default: "draft")*: Values: draft, pending, approved, fulfilled, cancelled.
- **description** *(optional)*: Order notes.
- **total_amount** *(optional)*: Total order amount.
- **order_date** *(optional)*: Epoch timestamp.
- **order_line_list** *(optional)*: Array of line items,
  e.g. `[{"description":"Widget","amount":99.99,"line_detail_dict":{"qty":1,"unit_price":99.99}}]`.

**Response:** The created order object.

## Request body

- OrderRequest — Request to create a new order.
  - `name` string, nullable — Order name
  - `order_type` string, nullable — Possible values: sales, quote
  - `account_id` string, nullable — FK to Accounts
  - `contact_id` string, nullable — FK to AccountContacts
  - `stage` string, nullable — Order stage, e.g. draft, pending, approved, fulfilled, cancelled
  - `description` string, nullable — Order description / notes
  - `total_amount` number, nullable — Total order amount
  - `order_date` integer, nullable — Order date (epoch timestamp)
  - `order_line_list` unknown[], nullable — Array of OrderLine objects, e.g. [{"description":"Widget","amount":99.99,"line_detail_dict":{"qty":1,"unit_price":99.99}}]
    - unknown

## Response `200`

Successful Response

- OrderResponse
  - `id` string, required
  - `name` string, nullable
  - `stage` string, nullable
  - `description` string, nullable
  - `order_num` string, nullable
  - `order_type` string, nullable
  - `order_date` string, nullable
  - `total_amount` string, nullable
  - `agreement_signed_date` string, nullable
  - `created_ts` string, nullable
  - `created_ts_date` string, nullable
  - `updated_ts` string, nullable
  - `updated_ts_date` string, nullable
  - `account` string, nullable
  - `primary_sales_agent_email` string, nullable
  - `contact` string, nullable
  - `opportunity` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/ambivo/apis/ambivo-api.md) · [All operations](https://skmtc.net/ambivo/apis/ambivo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ambivo/ambivo-api/versions/165a6d16a9a0/schema)