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

# Dropshipment v2 - Createuserorder

`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 Withings user, then creates a dropshipment order and links the devices shipped to the created user once the device is shipped. If a cellular device is listed in the order field, the service will activate this device's cellular service and invoicing.

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

Please refer to the [Access and refresh tokens section](/developer-guide/v3/integration-guide/dropship-cellular/get-access/access-and-refresh-tokens) to learn how to use the authorization code you'll get in return of this service in order to fetch user data. The authorization code is only valid for *10 minutes*.

*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.*
*Use this service only if you're integrating Withings Cellular Solutions with dropshipment.*

## Query parameters

- `action` string, required
- `client_id` string, required
- `nonce` string, required
- `signature` string, required
- `mailingpref` boolean, required
- `birthdate` integer, required
- `measures` unknown, required
- `gender` integer, required
- `preflang` string, required
- `unit_pref` unknown, required
- `email` unknown, required
- `timezone` unknown, required
- `shortname` string, required
- `external_id` string, required
- `order` unknown, required
- `firstname` string
- `lastname` string
- `phonenumber` string
- `recovery_code` string
- `goals` unknown
- `testmode` integer

## 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.
    - `user` object
      - `code` string: Authorization Code that must be used to retrieve access_token and refresh_token. (Read the "Get access to your user's data" section of your [integration guide](/developer-guide/v3/withings-solutions/integration-guides) to learn more about how to get this parameter.)
      - `external_id` string: Unique identifier used by partner to identify the end-user.
    - `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)