Skip to main content
POST
{orders_api_base_url}
/
orders
/
create
Create New Order
curl --request POST \
  --url 'https://api.example.com/{{orders_api_base_url}}/orders/create/' \
  --header 'Content-Type: application/json' \
  --data '
{
  "store_id": "<string>",
  "customer": {
    "customer_name": "<string>",
    "contact_phone": "<string>",
    "email": "<string>",
    "delivery_address": {
      "street": "<string>",
      "city": "<string>",
      "state": "<string>",
      "zip_code": "<string>",
      "apartment": "<string>",
      "delivery_instructions": "<string>"
    }
  },
  "order_items": [
    {
      "item_id": "<string>",
      "quantity": 123,
      "special_instructions": "<string>",
      "modifiers": [
        {}
      ]
    }
  ],
  "order_type": "<string>",
  "partner": "<string>",
  "payment_method": "<string>",
  "special_instructions": "<string>",
  "scheduled_time": "<string>",
  "created_by": "<string>"
}
'
{
  "success": true,
  "message": "<string>",
  "order": {
    "id": "<string>",
    "order_number": "<string>",
    "subtotal": "<string>",
    "tax_amount": "<string>",
    "total_price": "<string>",
    "status": "<string>",
    "estimated_ready_time": "<string>",
    "createdAt": "<string>",
    "fulfillment_id": "<string>"
  }
}
This endpoint allows stores to create new orders directly in the system, bypassing delivery platforms. This is useful for in-store purchases, phone orders, catering orders, or any direct customer transactions.
This endpoint creates orders that are immediately available for fulfillment and can be integrated with your existing POS system or used for direct customer service.

​
Request Body

​
store_id
string
required
The unique identifier of the store creating the order
​
customer
object
required
Customer information for the order
​
order_items
array
required
Array of items to include in the order
​
order_type
string
required
Type of order: “pickup”, “delivery”, “dine_in”
​
partner
string
default:"LulaDirect"
Source platform (defaults to “LulaDirect” for manual orders)
​
payment_method
string
required
Payment method: “cash”, “card”, “online”, “corporate_account”
​
special_instructions
string
General order-level special instructions
​
scheduled_time
string
Scheduled pickup/delivery time (ISO 8601 format). If not provided, order is for immediate fulfillment
​
created_by
string
required
Employee ID who created the order

​
Response

​
success
boolean
Indicates whether the order was successfully created
​
message
string
Confirmation message or error details
​
order
object
Complete order object with all calculated values

​
Request Example

{
  "store_id": "449235c1-3d04-4519-998b-40d2a621e5e0",
  "customer": {
    "customer_name": "John Smith",
    "contact_phone": "+1 555-123-4567",
    "email": "[email protected]",
    "delivery_address": {
      "street": "123 Main Street",
      "city": "Chicago",
      "state": "IL",
      "zip_code": "60601",
      "apartment": "Apt 4B",
      "delivery_instructions": "Ring doorbell twice"
    }
  },
  "order_items": [
    {
      "item_id": "prod_12345",
      "quantity": 2,
      "special_instructions": "Extra hot",
      "modifiers": [
        {
          "modifier_id": "size_large",
          "value": "Large"
        }
      ]
    },
    {
      "item_id": "prod_67890",
      "quantity": 1,
      "special_instructions": "No ice"
    }
  ],
  "order_type": "delivery",
  "partner": "LulaDirect",
  "payment_method": "card",
  "special_instructions": "Please call when arriving",
  "scheduled_time": "2024-01-15T18:30:00Z",
  "created_by": "emp_abc123"
}

​
Response Example

{
  "success": true,
  "message": "Order successfully created and added to fulfillment queue",
  "order": {
    "id": "ord_new_123456",
    "order_number": "LD-2024-001234",
    "subtotal": "28.50",
    "tax_amount": "2.28",
    "total_price": "30.78",
    "status": "confirmed",
    "estimated_ready_time": "2024-01-15T18:30:00Z",
    "createdAt": "2024-01-15T17:45:00Z",
    "fulfillment_id": "ful_abc789",
    "customer": {
      "customer_name": "John Smith",
      "contact_phone": "+1 555-123-4567",
      "email": "[email protected]"
    },
    "order_items": [
      {
        "id": "oi_item1",
        "item_name": "Large Coffee",
        "quantity": 2,
        "unit_price": "4.50",
        "total_price": "9.00",
        "special_instructions": "Extra hot"
      },
      {
        "id": "oi_item2",
        "item_name": "Iced Tea",
        "quantity": 1,
        "unit_price": "3.25",
        "total_price": "3.25",
        "special_instructions": "No ice"
      }
    ]
  }
}
When an order is created, the following processes occur automatically:
  1. Inventory Check: Verify item availability
  2. Price Calculation: Calculate subtotal, taxes, and total
  3. Order Number Generation: Create unique customer-facing order number
  4. Fulfillment Creation: Initialize fulfillment tracking
  5. Kitchen Notification: Alert preparation staff (if applicable)
  6. Customer Notification: Send confirmation (if email provided)
  7. Payment Hold: Initiate payment processing (for card payments)
Order Numbers: The system generates human-readable order numbers (e.g., “LD-2024-001234”) for customer reference, separate from the internal UUID.
Scheduled Orders: Use the scheduled_time parameter for advance orders. The order will automatically enter the fulfillment queue at the appropriate time.

​
Error Responses

Item Not Available
{
  "success": false,
  "message": "One or more items are not available",
  "error_code": "ITEM_UNAVAILABLE",
  "unavailable_items": ["prod_12345"]
}
Invalid Address (for delivery orders)
{
  "success": false,
  "message": "Delivery address is outside service area",
  "error_code": "INVALID_DELIVERY_ADDRESS"
}
Payment Processing Error
{
  "success": false,
  "message": "Payment method could not be processed",
  "error_code": "PAYMENT_FAILED"
}
Payment Processing: For card payments, ensure your payment processor is configured correctly. Failed payment processing will prevent order creation.

​
Use Cases

Phone Orders
  • Customer calls to place order
  • Staff member creates order in system
  • Customer pays on pickup/delivery
In-Store Purchases
  • Walk-in customer orders
  • Immediate or scheduled preparation
  • Integration with POS system
Catering Orders
  • Large scheduled orders
  • Corporate accounts
  • Advance preparation planning
Special Events
  • Pre-orders for events
  • Bulk order management
  • Custom pricing arrangements