> ## Documentation Index
> Fetch the complete documentation index at: https://exsited.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Create an order through the express path

> Creates an order, and its invoice and payment if the body nests them, in one call.

Send the account's `id` and the order under `account`, as for `POST /express`. Nest an invoice and payment in the body to create them in the same call.

> [!WARNING]
>
> **To create an order with its invoice in one call, use [Create an order with its invoice](https://exsited.mintlify.site/api-reference/express/create-an-order-with-its-invoice.md).**

> [!NOTE]
>
> The SDK samples get their client from credentials your app registers once when it starts, as shown in [Authentication](https://exsited.mintlify.site/authentication.md#set-up-a-client). To try the call here, click **Try it**, set `host` to your Exsited API host name and paste an access token from [Get an access token](https://exsited.mintlify.site/api-reference/authentication/get-an-access-token.md). To send a raw JSON body instead of filling in fields, copy the cURL sample and edit its `-d` payload.


## OpenAPI

````yaml POST /orders/express
openapi: 3.1.0
info:
  title: Exsited API
  version: v4
servers:
  - url: https://{host}/api/v4
    variables:
      host:
        default: your-api-host.example.com
        description: Your Exsited API host name, without https://.
security:
  - bearerAuth: []
tags:
  - name: Authentication
  - name: Accounts
  - name: Account emails
  - name: Account groups
  - name: Communications
  - name: Communication profiles
  - name: Orders
  - name: Quote orders
  - name: Express
  - name: Usages
  - name: Sales reps
  - name: Gift certificates
  - name: Invoices
  - name: Pro-forma invoices
  - name: Payments
  - name: Refunds
  - name: Credit notes
  - name: Credit note applications
  - name: Reconciliations
  - name: Items
  - name: Inventory adjustments
  - name: Units of measurement
  - name: Zones
  - name: Shipping packages
  - name: Shipping rules
  - name: Fulfillment profiles
  - name: Fulfillment terms
  - name: Item fulfillments
  - name: Item receipts
  - name: Bookings
  - name: Rental assets
  - name: Return merchandise authorisations
  - name: Purchase orders
  - name: Purchase invoices
  - name: Purchase payments
  - name: Purchase refunds
  - name: Purchase credit notes
  - name: Purchase credit note applications
  - name: Purchase express
  - name: Return vendor authorizations
  - name: ABA files
  - name: Receive terms
  - name: Labours
  - name: Tasks
  - name: Timesheets
  - name: Milestones
  - name: Employees
  - name: Departments
  - name: Designations
  - name: Teams
  - name: Time periods
  - name: Workflows
  - name: Workflow settings
  - name: Events
  - name: Custom events
  - name: System events
  - name: Approvals
  - name: Approval profiles
  - name: Approval user groups
  - name: Alerts
  - name: Alert responsibility settings
  - name: Alert responsibilities
  - name: Action scripts
  - name: Note groups
  - name: Note attachments
  - name: Instance settings
  - name: Accounting codes
  - name: Additional codes
  - name: Billing periods
  - name: Charging periods
  - name: Pricing periods
  - name: Invoice terms
  - name: Days of the month
  - name: Countries
  - name: Salutations
  - name: Document templates
  - name: Email templates
  - name: Roles
  - name: Operators
  - name: Operator groups
  - name: User settings
  - name: Custom attributes
  - name: Custom components
  - name: Custom features
  - name: Custom fields
  - name: Custom forms
  - name: Attribute attachments
  - name: Portal
  - name: Integration connections
  - name: External databases
  - name: Reports
  - name: Applications
  - name: Organisation
  - name: Child organisations
  - name: Webhooks
paths:
  /orders/express:
    post:
      tags:
        - Orders
      summary: Create an order through the express path
      description: >-
        Send the account's `id` and the order under `account`, as for `POST
        /express`. Nest an invoice and payment in the body to create them in the
        same call.
      operationId: orders_create_order_express
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                account:
                  type: object
                  properties:
                    id:
                      type: string
                      description: The account's `id`.
                    order:
                      type: object
                      properties:
                        price_tax_inclusive:
                          type: boolean
                        properties:
                          type: object
                          properties:
                            fulfillment_mode:
                              type: string
                            fulfillment_term:
                              type: string
                        lines:
                          type: array
                          items:
                            type: object
                            properties:
                              item_id:
                                type: string
                              item_order_quantity:
                                type: integer
                              item_price_snapshot:
                                type: object
                                properties:
                                  pricing_rule:
                                    type: object
                                    properties:
                                      price:
                                        type: number
                              tax_exempt_when_sold:
                                type: boolean
                  required:
                    - id
                    - order
              required:
                - account
            example:
              account:
                id: ACC0001
                order:
                  price_tax_inclusive: false
                  properties:
                    fulfillment_mode: MANUAL
                    fulfillment_term: IMMEDIATELY
                  lines:
                    - item_id: ITEM-0001
                      item_order_quantity: 2
                      item_price_snapshot:
                        pricing_rule:
                          price: 1.5
                      tax_exempt_when_sold: true
      responses:
        '201':
          description: The order is created.
      x-codeSamples:
        - lang: bash
          label: cURL
          source: |-
            curl -X POST "$EXSITED_BASE_URL/api/v4/orders/express" \
              -H "Authorization: Bearer $ACCESS_TOKEN" \
              -H "Content-Type: application/json" \
              -d '{
                "account": {
                  "id": "ACC0001",
                  "order": {
                    "price_tax_inclusive": false,
                    "properties": {
                      "fulfillment_mode": "MANUAL",
                      "fulfillment_term": "IMMEDIATELY"
                    },
                    "lines": [
                      {
                        "item_id": "ITEM-0001",
                        "item_order_quantity": 2,
                        "item_price_snapshot": {
                          "pricing_rule": {
                            "price": 1.5
                          }
                        },
                        "tax_exempt_when_sold": true
                      }
                    ]
                  }
                }
              }'
        - lang: python
          label: Python
          source: |
            from exsited import build_client

            client = build_client()

            response = client.orders.create_order_express(
                {
                    "account": {
                        "id": "ACC0001",
                        "order": {
                            "price_tax_inclusive": False,
                            "properties": {
                                "fulfillment_mode": "MANUAL",
                                "fulfillment_term": "IMMEDIATELY",
                            },
                            "lines": [
                                {
                                    "item_id": "ITEM-0001",
                                    "item_order_quantity": 2,
                                    "item_price_snapshot": {"pricing_rule": {"price": 1.5}},
                                    "tax_exempt_when_sold": True,
                                }
                            ],
                        },
                    }
                }
            )
            print(response.data)
        - lang: javascript
          label: JavaScript
          source: |
            import {buildClient} from 'exsited';

            const client = await buildClient();

            const response = await client.orders.createOrderExpress({
                account: {
                    id: 'ACC0001',
                    order: {
                        price_tax_inclusive: false,
                        properties: {fulfillment_mode: 'MANUAL', fulfillment_term: 'IMMEDIATELY'},
                        lines: [
                            {
                                item_id: 'ITEM-0001',
                                item_order_quantity: 2,
                                item_price_snapshot: {pricing_rule: {price: 1.5}},
                                tax_exempt_when_sold: true,
                            },
                        ],
                    },
                },
            });
            console.log(response.data);
        - lang: php
          label: PHP
          source: |
            use Exsited\Client\ClientRegistry;

            $client = ClientRegistry::buildClient();

            $response = $client->orders->createOrderExpress([
                'account' => [
                    'id' => 'ACC0001',
                    'order' => [
                        'price_tax_inclusive' => false,
                        'properties' => ['fulfillment_mode' => 'MANUAL', 'fulfillment_term' => 'IMMEDIATELY'],
                        'lines' => [
                            [
                                'item_id' => 'ITEM-0001',
                                'item_order_quantity' => 2,
                                'item_price_snapshot' => ['pricing_rule' => ['price' => 1.5]],
                                'tax_exempt_when_sold' => true,
                            ],
                        ],
                    ],
                ],
            ]);
            print_r($response->data);
        - lang: java
          label: Java
          source: |
            import com.exsited.Dto;
            import com.exsited.client.ApiResponse;
            import com.exsited.client.ClientRegistry;
            import com.exsited.client.ExsitedClient;
            import java.util.List;
            import java.util.Map;

            ExsitedClient client = ClientRegistry.buildClient();

            ApiResponse<Dto> response = client.orders().createOrderExpress(
                    Map.of(
                            "account", Map.of(
                                    "id", "ACC0001",
                                    "order", Map.of(
                                            "price_tax_inclusive", false,
                                            "properties", Map.of(
                                                    "fulfillment_mode", "MANUAL",
                                                    "fulfillment_term", "IMMEDIATELY"),
                                            "lines", List.of(
                                                    Map.of(
                                                            "item_id", "ITEM-0001",
                                                            "item_order_quantity", 2,
                                                            "item_price_snapshot", Map.of(
                                                                    "pricing_rule", Map.of("price", 1.5)),
                                                            "tax_exempt_when_sold", true))))));
            System.out.println(response.getMap());
        - lang: csharp
          label: .NET
          source: >
            using Exsited.Client;


            await using var client = ExsitedClient.BuildClient();


            var response = await client.Orders.CreateOrderExpressAsync(new
            Dictionary<string, object?>

            {
                ["account"] = new Dictionary<string, object?>
                {
                    ["id"] = "ACC0001",
                    ["order"] = new Dictionary<string, object?>
                    {
                        ["price_tax_inclusive"] = false,
                        ["properties"] = new Dictionary<string, object?>
                        {
                            ["fulfillment_mode"] = "MANUAL",
                            ["fulfillment_term"] = "IMMEDIATELY",
                        },
                        ["lines"] = new List<object?>
                        {
                            new Dictionary<string, object?>
                            {
                                ["item_id"] = "ITEM-0001",
                                ["item_order_quantity"] = 2,
                                ["item_price_snapshot"] = new Dictionary<string, object?>
                                {
                                    ["pricing_rule"] = new Dictionary<string, object?>
                                    {
                                        ["price"] = 1.5,
                                    },
                                },
                                ["tax_exempt_when_sold"] = true,
                            },
                        },
                    },
                },
            });


            Console.WriteLine(response.Json);
        - lang: dart
          label: Dart
          source: |
            import 'package:exsited/exsited.dart';

            final client = buildClient();

            final response = await client.orders.createOrderExpress({
              'account': {
                'id': 'ACC0001',
                'order': {
                  'price_tax_inclusive': false,
                  'properties': {
                    'fulfillment_mode': 'MANUAL',
                    'fulfillment_term': 'IMMEDIATELY',
                  },
                  'lines': [
                    {
                      'item_id': 'ITEM-0001',
                      'item_order_quantity': 2,
                      'item_price_snapshot': {
                        'pricing_rule': {'price': 1.5},
                      },
                      'tax_exempt_when_sold': true,
                    },
                  ],
                },
              },
            });
            print(response.map);
        - lang: go
          label: Go
          source: "import (\n\t\"context\"\n\t\"fmt\"\n\t\"log\"\n\n\texsited \"github.com/exsited/exsited-sdk-go/v4\"\n)\n\nclient, err := exsited.BuildClient(nil)\nif err != nil {\n\tlog.Fatal(err)\n}\ndefer client.Close()\n\nresponse, err := client.Orders().CreateOrderExpress(context.Background(), map[string]any{\n\t\"account\": map[string]any{\n\t\t\"id\": \"ACC0001\",\n\t\t\"order\": map[string]any{\n\t\t\t\"price_tax_inclusive\": false,\n\t\t\t\"properties\": map[string]any{\n\t\t\t\t\"fulfillment_mode\": \"MANUAL\",\n\t\t\t\t\"fulfillment_term\": \"IMMEDIATELY\",\n\t\t\t},\n\t\t\t\"lines\": []any{\n\t\t\t\tmap[string]any{\n\t\t\t\t\t\"item_id\":             \"ITEM-0001\",\n\t\t\t\t\t\"item_order_quantity\": 2,\n\t\t\t\t\t\"item_price_snapshot\": map[string]any{\n\t\t\t\t\t\t\"pricing_rule\": map[string]any{\"price\": 1.5},\n\t\t\t\t\t},\n\t\t\t\t\t\"tax_exempt_when_sold\": true,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t},\n}, nil)\nif err != nil {\n\tlog.Fatal(err)\n}\nfmt.Println(response.Map)\n"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        An access token from `POST /api/v4/oauth2/token`. The SDKs get and renew
        it for you.

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.