Create order in Square
POS API · write, waits for approval · 100% field coverage
Your agent can create order in Square through Apideck's POS API, the same call it makes for every POS app. It changes data in the customer's Square account, so it stops with the exact request until a person approves it. Apideck adds the customer's Square credentials, so no token ever reaches the agent.
The call
POST https://unify.apideck.com/pos/orders
Headers: x-apideck-service-id: square, plus your app id and the customer's consumer id. Apideck MCP tool: pos-orders-add. Agent operation id: unified.pos.ordersAdd.
Body fields
| Field | Type | Description |
|---|---|---|
| idempotency_key | string | A value you specify that uniquely identifies this request among requests you have sent. |
| order_number | string | |
| order_date | string | |
| closed_date | string | |
| reference_id | string | An optional user-defined reference ID that associates this record with another entity in an external system. For example |
| status | string | Order status. Clover specific: If no value is set, the status defaults to hidden, which indicates a hidden order. A hidd |
| payment_status | string | Is this order paid or not? |
| currency | string | Indicates the associated currency for an amount of money. Values correspond to [ISO 4217](https://en.wikipedia.org/wiki/ |
| title | string | |
| note | string | A note with information about this order, may be printed on the order receipt and displayed in apps |
| merchant_id · required | string | |
| customer_id | string | |
| employee_id | string | |
| location_id · required | string | |
| order_type_id | string | |
| table | string | |
| seat | string | |
| total_amount | integer | |
| total_tip | integer | |
| total_tax | integer | |
| total_discount | integer | |
| total_refund | integer | |
| total_service_charge | integer | |
| refunded | boolean | |
| customers | array | |
| fulfillments | array | |
| line_items | array | |
| payments | array | |
| service_charges | array | Optional service charges or gratuity tip applied to the order. |
| refunds | array | |
| taxes | array | |
| discounts | array | |
| tenders | array | |
| voided | boolean | |
| version | string |
More for orders in Square
Create order in other POS apps
The same call works for each of these; only the service id changes.