---
title: "Dropshipment v2 - Createorder"
method: POST
path: "https://wbsapi.withings.net/v2/dropshipment"
tags: ["dropshipment"]
---

# Dropshipment v2 - Createorder

`POST https://wbsapi.withings.net/v2/dropshipment`

## Request

- Base URL: `https://wbsapi.withings.net`
- URL: `https://wbsapi.withings.net/https://wbsapi.withings.net/v2/dropshipment`
- Auth: none declared

Creates a dropshipment order.

If one of the orders has an invalid address, none of the orders will be created.

*This service is part of Withings Pro Solutions. You won't be able to use it if you did not sign a contract with Withings.*
*Do not use this service if you're integrating Withings Cellular Solutions with dropshipment. In that case, please use the createuserorder action*

## Query parameters

- `action` string, required
- `client_id` string, required
- `nonce` string, required
- `signature` string, required
- `order` unknown, required
- `customerid` string
- `testmode` integer
- `platformid` unknown

## Response `200`

(Click to unfold)

- object
  - `status` integer: Response status. See <a href='#tag/response_status'>Status</a> section for details.
  - `body` object: Response data.
    - `orders` DropshipmentCreateOrderObject[]: List of created orders. *(Only if orders were successfully created)*
      - `order_id` string: Withings generated identifier used to track your order.
      - `customer_ref_id` string: Random identifier you must provide in input parameters. It is used to track your order and must be unique.
      - `dropshipmentorderid` string: Unique identifier of the dropshipment order.
      - `status` string: Status of the order. Value can be: | Value| |---| |CREATED| |ADDRESS VERIFICATION| |ADDRESS ERROR| |VERIFIED| |PROCESSING| |FAILED| |OPEN| |SHIPPED| |TRASHED| |BACKHOLD|
      - `products` DropshipmentCreateOrderProductObject[]
        - `ean` string: EAN of the product.
        - `partner_ref` string
        - `quantity` integer: Quantity of products.
    - `dropshipmentorderid` string: Unique identifier of the dropshipment order.
    - `invalid_address_customer_ref_ids` string[]: References of the orders with invalid address. *(Only if at least one order has an invalid address)*

---

[API](https://skmtc.dev/withings/apis/withings-developer-documentation.md) - [All operations](https://skmtc.dev/withings/apis/withings-developer-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/withings/apis/withings-developer-documentation/revisions/9e9accd01d4b?raw)