create_order
Directly create a Shopify order with explicit line-item pricing, bypassing draft orders. Use for historical imports or phone/in-person sales when automatic tax and shipping calculation is not needed.
Instructions
Create a real Shopify order directly, bypassing the draft-order flow. Each line item is either a variant reference (variantId + quantity) or a custom item (title + priceSet + quantity). Use when you need to import historical orders, record a phone/in-person sale, or create an order without involving Shopify's checkout pricing engine. For interactive carts where Shopify should compute taxes/shipping/discounts, use create_draft_order then complete_draft_order instead. Defaults: PENDING financial status, customer not notified, inventory decremented respecting each variant's oversell policy.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lineItems | Yes | At least one line item. Each is either a variant reference (variantId + quantity) or a custom item (title + priceSet + quantity). Use draft orders (create_draft_order → complete_draft_order) when you want Shopify to handle pricing/taxes automatically; use this tool when you need to create an order directly with explicit line-item pricing. | |
| No | Customer email for the order. Recommended even when customerId is set. | ||
| customerId | No | GID of an existing customer to attach. Get one from list_customers. Optional. | |
| tags | No | Tags applied to the new order. | |
| note | No | Internal staff-only note attached to the order. | |
| financialStatus | No | Initial financial status to record. Defaults to PENDING if omitted. Use PAID when capturing payment outside Shopify (manual offline payment). | |
| sendReceipt | No | Whether to email the customer a receipt for the new order. | |
| inventoryBehaviour | No | How inventory is handled. BYPASS: don't touch inventory. DECREMENT_OBEYING_POLICY (default): decrement and respect each variant's oversell policy. DECREMENT_IGNORING_POLICY: decrement always, even past zero. |