> ## Documentation Index
> Fetch the complete documentation index at: https://docs.textyess.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Create Order
> Send new order data to TextYess to unlock analytics and automations
## Overview
The v2 new-order webhook lets TextYess receive your orders so it can attribute them to the WhatsApp
conversations, campaigns, and automations that drove them, and power analytics. It is CMS-agnostic:
map your store's order to the contract below once, whatever platform you use.
**Automations only fire for recent orders.** Flows with a new-order trigger run only when the
order's `created_at` is within the last 24 hours. Older orders are still ingested for analytics
and attribution, so backfilling historical orders is safe — it will never message your customers.
## Authentication
Send your organization token in the `x-auth-token` header. You can find both your token and your
organization id in the [Developers section](https://ai.textyess.com/developers):
```bash theme={null}
x-auth-token: your_token
```
### Path Parameters
Your organization id, from [https://ai.textyess.com/developers](https://ai.textyess.com/developers)
### Body Parameters
Your source order id. Used for idempotency — re-sending the same id for an organization is a no-op, so retries are safe.
The order timestamp (ISO 8601). A value without a timezone is treated as UTC. Send the real order date so historical orders attribute correctly — it also gates automations: flows run only when `created_at` is within the last 24 hours.
Free-text payment/order status.
`paid` / `complete` / `completed` / `processing` / `captured` / `success` count as paid; `refunded` / `partially_refunded` / `closed` as refunded; `canceled` / `voided` / `failed` as voided; any other value counts as pending.
The grand total in currency units. A numeric string ("99.90") is also accepted.
The payment methods used for the order.
The items in the order.
Item title
Quantity
Unit price
SKU
Variant title
Product id
Customer identity. For anonymous orders, supply placeholder values you control.
Customer email
Customer phone (paired with country\_code)
ISO country code for the phone
Source customer id
First name
Last name
Locale
ISO currency code. Defaults to EUR when omitted.
Human-facing order number / increment id.
Free-text fulfillment status.
Tracking URL for the shipment.
Shipping address (all fields optional).
First name
Last name
Company
Address line 1
Address line 2
City
Province / state
Province code
Country
Country code
ZIP / postal code
Phone
Billing address — same shape as `shipping_address` (all fields optional).
Discount codes applied to the order.
Code
Discount amount
Discount type
Cart identifier (enables onsite-chat attribution).
Subtotal.
Total tax.
Total discount.
Total shipping.
### Response
Whether the webhook was processed.
```json 200 theme={null}
{ "success": true }
```
```json 400 theme={null}
{
"code": 400,
"message": "Validation failed"
}
```
```json 401 theme={null}
{
"code": 401,
"message": "Unauthorized"
}
```