---
title: "Create a order"
method: POST
path: "/v2/orders"
---

# Create a order

`POST /v2/orders`

## Request

- Base URL: `https://api.corporatemerch.com`
- URL: `https://api.corporatemerch.com/v2/orders`
- Auth: API key in header `Authorization`

Create a new order. If your order includes products that ship from multiple facilities, each facility’s products will be processed as a separate shipment within the overarching order.

## Headers

- `Idempotency-Key` string

## Request body

- object
  - `first_name` string, required
  - `last_name` string, required
  - `company` string
  - `phone_number` string: Required for int'l orders
  - `email` string: Required for int'l orders
  - `address1` string, required
  - `address2` string
  - `city` string, required
  - `state` string, required: 2 character code for USA states.
  - `zip_code` string, required
  - `country` string, required: 2 character country code. (eg: US)
  - `notecard_message` string
  - `notecard_logo` string, binary
  - `notecard_url` string: The notecard URL, if defined, will be used rather than the notecard message and logo
  - `products` object[]
    - `quantity` integer, required: The quantity of the item
    - `product_id` integer, required: The product ID
    - `variant_id` integer: <span style="color:#dd1e2e">conditionally required</span> - The variant ID. Required if product has variants. `null` can be passed for products that doesn't have variants
  - `shopify_order_id` string: Utilize this field as your external order reference
  - `billing_name` string
  - `billing_address_1` string
  - `billing_address_2` string
  - `billing_zip_code` string
  - `billing_city` string
  - `billing_state` string
  - `skip_address_validation` boolean: Utilize this field to override our address verification

## Response `201`

201

- object
  - `data` object
    - `id` integer
    - `first_name` string
    - `last_name` string
    - `company` string
    - `phone` string
    - `email` string
    - `address1` string
    - `address2` string
    - `city` string
    - `state` string
    - `zip_code` string
    - `country` string
    - `status` string
    - `created_at` string
    - `notecard` object
      - `id` integer
      - `name` string
      - `message` string
      - `logo` object
        - `id` integer
        - `src` string
        - `created_at` string
    - `shipment_cost` object
      - `products` string
      - `notecard` string
      - `shipping` string
      - `tax` string
      - `duty` string
      - `other` string
      - `total_cost` string
    - `shopify_order_id` unknown
    - `billing_name` unknown
    - `billing_address_line_1` unknown
    - `billing_address_line_2` unknown
    - `billing_city` unknown
    - `billing_state` unknown
    - `billing_zip_code` unknown
    - `shipments` object[]
      - `id` integer
      - `order_id` integer
      - `status` string
      - `carrier_code` unknown
      - `tracking_number` unknown
      - `tracking_url` unknown
      - `created_at` string
      - `products` object[]
        - `id` integer
        - `variant_id` integer
        - `quantity` integer
        - `unit_price` string

## Other responses

- `422`: 422

---

[API](https://skmtc.dev/corporatemerch/apis/corporate-merch.md) - [All operations](https://skmtc.dev/corporatemerch/apis/corporate-merch/llms.txt) - [OpenAPI document](https://skmtc.dev/corporatemerch/apis/corporate-merch/revisions/1739fae86fb3?raw)
