---
title: "POST /v1/vendor/orders"
method: POST
path: "/v1/vendor/orders"
tags: ["api.order.v1.OrderAPI"]
---

# POST /v1/vendor/orders

`POST /v1/vendor/orders`

## Request body

- ApiOrderV1CreateDraftOrderRequest
  - `orderRef` string
  - `externalId` string
  - `shippingInfo` ApiOrderV1CreateDraftOrderRequestShippingInfo
    - `email` string, email
    - `name` string
    - `phone` string
    - `companyName` string
    - `address1` string
    - `address2` string
    - `city` string
    - `provinceCode` string
    - `zipcode` string
    - `countryCode` string
    - `method` string
  - `lineItems` ApiOrderV1CreateDraftOrderRequestLineItem[]
    - `productId` string
    - `productName` string
    - `productStyle` string
    - `variantSku` string
    - `quantity` integer
    - `printingOption` ApiOrderV1CreateDraftOrderRequestPrintingOption
      - `frontDesignUrl` string
      - `backDesignUrl` string
  - `storeId` string
  - `processWithRisk` boolean
  - `giftMessageBody` string
  - `iossNumber` union
    - string
    - number
  - `iossNumberTotal` union
    - string
    - number
  - `taxNumber` string
  - `orderTaxValue` union
    - string
    - number
  - `shippingServiceType` string
  - `shippingLabelUrl` string, uri

## Response `200`

- ApiOrderV1CreateDraftOrderResponse
  - `draftOrder` ApiOrderV1DraftOrder
    - `draftOrderId` string
    - `orderRef` string
    - `externalId` string
    - `shippingInfo` ApiOrderV1DraftOrderShippingInfo
      - `email` string
      - `name` string
      - `phone` string
      - `companyName` string
      - `address1` string
      - `address2` string
      - `city` string
      - `provinceCode` string
      - `zipcode` string
      - `countryCode` string
      - `method` string
    - `lineItems` ApiOrderV1DraftOrderLineItem[]
      - `variantId` string
      - `productName` string
      - `productStyle` string
      - `productSku` string
      - `quantity` integer
      - `printingOption` ApiOrderV1DraftOrderPrintingOption
        - `frontDesignUrl` string
        - `backDesignUrl` string

## Other responses

- `default`

---

[API](https://skmtc.dev/gearment/apis/api-webhook-v1.md) · [All operations](https://skmtc.dev/gearment/apis/api-webhook-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/gearment/api-webhook-v1/revisions/a2e58da78818/schema)