POST

Order.Add

Create an orders_for_cust row (dashboard setting/orders_for_cust insert). Custom fields: send order-{unix}=value and/or custom_fields JSON.

Permissions

User must be logged in with a valid bearer token.
Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

Creates a Order record or sends the requested data after validation.

Push Service

No push is sent because this function only reads data or returns helper information.

Automation

No automation is run for this function.

Special Instructions

order_id is the catalog product id from Order.Catalog (without_date), not the list Order Number.
After insert, response order_id / orders_for_cust_id is the new row id (list Order Number).
ORDER SELECT / other custom columns use keys from Order.Fields (order_custom_fields[].name).
Multi-select values may be sent as arrays; stored as comma-separated in custom_fields.
Runs add_order automation best-effort like the dashboard.

Required Parameters

Name	Type	Sample	Explanation
`cust_id` post	int	`108545`	Customer id.
`order_id` post	int	`55`	Catalog orders.id. Aliases: product_order_id, catalog_order_id.

Optional Parameters

Name	Type	Sample	What it gives
`date` post	date	`2026-09-08`	Order date Y-m-d. Default 0000-00-00. Send date filters and date values as UTC Y-m-d H:i:s when the route accepts date/time; date-only table columns store the Y-m-d date part.
`notes` post	string	`this is T-shirt note`	Note column. Alias: note.
`price` post	string	`18`	book_price.
`total_price` post	string	`18`	Total Price column.
`discount` post	string	`0`	Discount.
`paid_status` post	int	`0`	0 unpaid, 1 paid, 2 partly.
`order_status` post	int	`12`	all_status id type=order_status.
`custom_fields` post	json	`{"order-1731":"opt1"}`	Optional JSON object of custom field values.

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Order.Add",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "cust_id": "108545",
        "order_id": "55",
        "total_price": "18",
        "notes": "this is T-shirt note",
        "order_status": "12"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Order.Add",
    "url_domain": "https:\/\/{domain}\/app\/Order.Add"
}

Endpoint

POST /app/Order.Add
POST https://{user}.bull36.com/app/Order.Add
POST https://{domain}/app/Order.Add

Sample Output

{
    "success": 1,
    "orders_for_cust_id": 267990,
    "order_id": 267990,
    "message": "Order add Successfully"
}

JavaScript Example

const body = new URLSearchParams({ cust_id: '108545', order_id: '55', total_price: '18', notes: 'note', order_status: '12' });
body.append('order-1731', 'opt1');
const res = await fetch('/app/Order.Add', { method: 'POST', headers: { Authorization: 'Bearer YOUR TOKEN' }, body });
console.log(await res.json());

Error Example

{
    "success": "0",
    "message": "Request failed"
}