---
title: "Create Order"
method: POST
path: "/v1/orders"
tags: ["Orders"]
---

# Create Order

`POST /v1/orders`

## Request

- Base URL: `https://api.1nce.com/management-api`
- URL: `https://api.1nce.com/management-api/v1/orders`
- Auth: HTTP bearer

Trigger an order using a POST request.

## Request body

- AdditionalOrder: Parameters of the order to be placed.
  - `products` OrderedProduct[], required: The specific products to be ordered.
    - `productId` integer: Specific id of the product to be ordered. For reference, check past orders or the product API call for avaliable product ids.
    - `quantity` integer: Quantity to be ordered of the given product.
  - `delivery_address` DeliveryAddress: Address where the products of the order should be delivered to. If no additional address is provided here, the ordered products will be sent to the existing single delivery address. If more than one default delivery address is configured in the 1NCE organization, please provide a valid shipping address in the order request.
    - `salutation` '1' | '2': Salutation, supported values are '1' for 'Mr' and '2' for 'Ms'.
    - `first_name` string: First Name
    - `last_name` string: Last Name
    - `company` string: Company Name
    - `street` string: Street Name
    - `address_line2` string: Second Address Line
    - `house_number` string: House Number
    - `zip` string: ZIP Code
    - `city` string: City
    - `country` string: ISO 3166-1 Alpha-2 Country Code
    - `phone` string: Phone Number with international prefix.
  - `customer_reference` string: Optional customer-specific reference for the order.

## Response `200`

OK

- AdditionalOrder: Parameters of the order to be placed.
  - `products` OrderedProduct[], required: The specific products to be ordered.
    - `productId` integer: Specific id of the product to be ordered. For reference, check past orders or the product API call for avaliable product ids.
    - `quantity` integer: Quantity to be ordered of the given product.
  - `delivery_address` DeliveryAddress: Address where the products of the order should be delivered to. If no additional address is provided here, the ordered products will be sent to the existing single delivery address. If more than one default delivery address is configured in the 1NCE organization, please provide a valid shipping address in the order request.
    - `salutation` '1' | '2': Salutation, supported values are '1' for 'Mr' and '2' for 'Ms'.
    - `first_name` string: First Name
    - `last_name` string: Last Name
    - `company` string: Company Name
    - `street` string: Street Name
    - `address_line2` string: Second Address Line
    - `house_number` string: House Number
    - `zip` string: ZIP Code
    - `city` string: City
    - `country` string: ISO 3166-1 Alpha-2 Country Code
    - `phone` string: Phone Number with international prefix.
  - `customer_reference` string: Optional customer-specific reference for the order.

## Other responses

- `201`: Created
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Not Found

---

[API](https://skmtc.dev/1nce/apis/order-management.md) - [All operations](https://skmtc.dev/1nce/apis/order-management/llms.txt) - [OpenAPI document](https://skmtc.dev/1nce/apis/order-management/revisions/2982e7c6ace1?raw)