Automate now

Shopify Order API 2026 – Create An Order Using Postman

By Beehexa Engineering TeamPublished Updated

Table of Contents

This tutorial shows how to create an order in a Shopify store from Postman with the Shopify Admin API: get an access token, build the POST orders.json request, send an order with tax lines split across taxable line items, and read the response. It was updated in November 2026 for the current way of getting a token and the current API version.

What changed since 2022. The first version of this guide used a Shopify “private app” and put the API key and password in the request URL. That is no longer how you get a token: since January 1, 2026 new custom apps are no longer created in the Shopify admin: Shopify’s Help Center says custom apps are created and managed in the Dev Dashboard. Requests now send the token in the X-Shopify-Access-Token header.

Before you start

Step 1: Get an Admin API access token

Create an app for your store in the Dev Dashboard and give it permission to write orders (Create apps using the Dev Dashboard):

  1. In the Dev Dashboard, open Apps, select Create app, choose Start from Dev Dashboard, name the app and select Create.
  2. On the app’s Versions page, select the access scopes the app needs. To create orders, add write_orders (the scope Shopify lists for creating orders in the orderCreate reference). Then select Release.
  3. Install the app on your store: select Install app from the app’s Installs card, choose the store and select Install.
  4. Open the app’s Settings and copy the Client ID and Client secret from the Credentials card.

Exchange the client ID and secret for an access token with the client credentials grant (Client credentials grant). In Postman, create this request:

POST https://{shop}.myshopify.com/admin/oauth/access_token
Content-Type: application/x-www-form-urlencoded

grant_type=client_credentials&client_id={client_id}&client_secret={client_secret}

{shop} is your store’s subdomain, without .myshopify.com. The response contains the token:

{
  "access_token": "{access_token}",
  "scope": "write_orders",
  "expires_in": 86399
}

Already have a legacy custom app? Custom apps created in the Shopify admin before January 1, 2026 keep working. Their Admin API access token was shown once when the app was installed, under Apps > Develop apps > your app > API credentials. If you no longer have it, uninstall and reinstall the app to generate a new one (Generate access tokens for admin-created custom apps). Make sure the app has the write_orders scope.

Step 2: Set up the request in Postman

Create a new request in Postman:

https://{shop}.myshopify.com/admin/api/{api_version}/orders.json

For example, with API version 2026-10: https://{shop}.myshopify.com/admin/api/2026-10/orders.json.

X-Shopify-Access-Token: {access_token}
Content-Type: application/json

Every REST Admin API request authenticates with the X-Shopify-Access-Token header. Don’t put the token, API key or password in the URL.

Step 3: Add the order JSON to the body

Open the Body tab, select raw and JSON. The smallest valid order has one line item. You can reference a product variant from your store:

{
  "order": {
    "line_items": [
      {
        "variant_id": 123456789,
        "quantity": 1
      }
    ]
  }
}

Replace 123456789 with the numeric ID of a variant in your store.

To create an order with tax lines split across taxable line items, send custom line items (title and price, no product) and the tax lines that apply to them. Here, the shoes are not taxable, so the state tax (6%) and county tax (2.5%) are applied to the coat and the two berets only:

{
  "order": {
    "line_items": [
      {
        "title": "Red Leather Coat",
        "price": 129.99,
        "grams": "1700",
        "quantity": 1
      },
      {
        "title": "Blue Suede Shoes",
        "price": 85.95,
        "grams": "750",
        "quantity": 1,
        "taxable": false
      },
      {
        "title": "Raspberry Beret",
        "price": 19.99,
        "grams": "320",
        "quantity": 2
      }
    ],
    "tax_lines": [
      {
        "price": 10.2,
        "rate": 0.06,
        "title": "State tax"
      },
      {
        "price": 4.25,
        "rate": 0.025,
        "title": "County tax"
      }
    ],
    "total_tax": 14.45
  }
}

The line_items say what is ordered (title, price, weight in grams and quantity), and the tax_lines say which taxes the taxable items are subject to and how much each one is. More examples (customer, addresses, transactions, inventory behaviour) are in the Order resource reference.

Step 4: Send the request and read the response

Click Send. A successful request returns 201 Created and the new order. The response is long; these are the fields to check (values shortened):

{
  "order": {
    "id": 4244165656639,
    "admin_graphql_api_id": "gid://shopify/Order/4244165656639",
    "name": "#1157",
    "financial_status": "paid",
    "currency": "AUD",
    "subtotal_price": "255.92",
    "total_tax": "14.45",
    "total_price": "270.37",
    "tax_lines": [
      { "price": "10.20", "rate": 0.06, "title": "State tax" },
      { "price": "4.25", "rate": 0.025, "title": "County tax" }
    ],
    "line_items": [
      {
        "title": "Red Leather Coat",
        "price": "129.99",
        "quantity": 1,
        "taxable": true,
        "tax_lines": [
          { "price": "7.81", "rate": 0.06, "title": "State tax" },
          { "price": "3.26", "rate": 0.025, "title": "County tax" }
        ]
      }
    ]
  }
}

Step 5: Verify the order in the Shopify admin

In the Shopify admin, go to Orders. The new order is at the top of the list.

The new order in the Shopify admin order list

Step 6: Fix common errors

The REST Admin API reference lists these status codes:

Status Meaning What to check
401 Unauthorized The authentication credentials are missing or incorrect. The X-Shopify-Access-Token header is present and spelled correctly, and the token is current (client credentials tokens expire after 24 hours).
403 Forbidden The request was refused, usually because the app lacks the required access scope. The app has write_orders, the version with that scope is released, and the app is installed on the store.
404 Not Found The resource doesn’t exist. The {shop} subdomain, the {api_version} and the path /orders.json.
422 Unprocessable Entity The request body is invalid: bad formatting, missing required fields or a logic error. The body is valid JSON wrapped in "order", the body type is raw / JSON, and every variant_id exists in the store.
429 Too Many Requests The app hit the rate limit. Wait the number of seconds in the Retry-After response header, then retry.

GraphQL alternative: orderCreate

The same order can be created with the GraphQL Admin API’s orderCreate mutation. It requires the write_orders scope and is meant for orders that don’t go through checkout, such as orders imported from another system. In Postman, send a POST to https://{shop}.myshopify.com/admin/api/{api_version}/graphql.json with the same X-Shopify-Access-Token header and select GraphQL as the body type. New public apps must use GraphQL, so prefer it for anything beyond a quick test.

Video

The video below was recorded in 2022 with the old private-app setup. The request body and the order in the admin are the same; get the token and set the header as in Steps 1 and 2 above.

YouTube video

If you have any questions, comment below or browse more tutorials in our Devdocs.