# Create Orders

Creates a new order in the ShipSaving system. Typically used to pre-create orders before generating shipping labels.
Rate limit: 300 requests per minute.

Endpoint: POST /api/orders/create
Version: v1
Security: ApiTokenAuth

## Request fields (application/json):

  - `store_name` (string, required)
    Store nickname as registered in your ShipSaving account (Stores > Stores Nickname).
    Example: "CS"

  - `order_number` (string)
    Unique identifier for the order. If omitted, one will be generated automatically.
    Example: "202402071641"

  - `warehouse_name` (string, required)
    Warehouse name as listed in your ShipSaving account (Warehouses > Warehouses name).
    Example: "WH"

  - `verify_address` (boolean, required)
    Indicates whether the recipient address should be verified.
    Example: true

  - `client_name` (string, required)
    Full name of the recipient.
    Example: "full name"

  - `client_company` (string)
    Company name of the recipient (if applicable).
    Example: "company name"

  - `client_email` (string)
    Email address of the recipient.

  - `client_phone` (string)
    Phone number of the recipient. Required for international shipments.
    Example: "1234567890"

  - `client_street` (string, required)
    Primary street address of the recipient.
    Example: "123 street name"

  - `client_street2` (string)
    Secondary address line, such as apartment or suite number.
    Example: "apt 123"

  - `client_city` (string, required)
    City of the recipient's address.
    Example: "city"

  - `client_state` (string, required)
    State or province of the recipient's address.
    Example: "state"

  - `client_zip` (string, required)
    ZIP or postal code of the recipient's address.
    Example: "zipcode"

  - `client_country` (string, required)
    2-letter code for origin country. This field’s value will be an [ISO 3166-1 two-digit code](https://en.wikipedia.org/wiki/ISO_3166-1).
    Example: "US"

  - `shipments` (array, required)
    List of shipment packages included in the order.

  - `shipments.length` (number)
    Length of the package in inches.
    Example: 6

  - `shipments.width` (number)
    Width of the package in inches.
    Example: 6

  - `shipments.height` (number)
    Height of the package in inches.
    Example: 3

  - `shipments.weight` (number)
    Weight of the package in pounds.
    Example: 0.4

  - `shipments.signature` (string)
    Signature requirement for delivery.
    Enum: "NO_SIGNATURE", "SIGNATURE", "ADULT_SIGNATURE"

  - `shipments.insurance_provider` (string)
    Insurance provider for the shipment.
    Enum: "SHIPSURANCE", "CARRIER."

  - `shipments.insurance_amount` (number)
    Value of insurance coverage in USD.
    Example: 200

  - `shipments.custom_print1` (string)
    Custom text to appear on the first line of the shipping label.
    Example: "this is a custom print 1 field"

  - `shipments.custom_print2` (string)
    Custom text to appear on the second line of the shipping label.
    Example: "this is a custom print 2 field"

  - `shipments.items` (array)
    List of individual items in the package.

  - `shipments.items.sku` (string, required)
    Stock Keeping Unit (SKU) of the item.
    Example: "2PCSFLCX-BLACK_PINK-S"

  - `shipments.items.title` (string)
    Descriptive title of the item.
    Example: "2 t-shirts"

  - `shipments.items.quantity` (integer, required)
    Number of units for this item.
    Example: 1

  - `shipments.items.price` (number, required)
    Unit price of the item.
    Example: 20

  - `shipments.items.tax` (number)
    Sales tax per unit.
    Example: 1.2

  - `shipments.items.shipping_cost` (number)
    Shipping cost allocated to the item.
    Example: 10

  - `shipments.notes` (array)
    Optional notes or instructions related to the shipment.
    Example: ["note 1","note 2"]

## Response 200 fields (application/json):

  - `order_number` (string)
    Order number