---
title: "User v2 - Link"
method: POST
path: "https://wbsapi.withings.net/v2/user  "
tags: ["user"]
---

# User v2 - Link

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

## Request

- Base URL: `https://wbsapi.withings.net`
- URL: `https://wbsapi.withings.net/https://wbsapi.withings.net/v2/user  `
- Auth: none declared. Required headers: `Authorization`

Links the devices related to the provided ```mac_addresses``` and the user related to the provided ```access_token```. If a cellular device is listed in the ```mac_address``` field, it will activate this device's cellular service and invoicing.

**Important**:

- Please note that the devices need to be authorized to be linked by API by the Partner. Please [contact Withings](mailto:partner-api@withings.com) for more information on device authorization.

## Query parameters

- `action` string, required
- `mac_addresses` unknown, required

## Headers

- `Authorization` string, required

## 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.
    - `devices` UserDeviceMacObject[]
      - `mac_address` string: Mac address of the device.
      - `type` string: Type of the device. Value can be: | Value| |---| |Scale| |Babyphone| |Blood Pressure Monitor| |Activity Tracker| |Sleep Monitor| |Smart Connected Thermometer| |Gateway| |Smart Meter| |HealthKit Apple| |HealthKit Google| |HealthKit Huawei| |Lingo| |Fluid Analyzer|
      - `model` string: Device model. Value can be: | Value | Description| |---|---| |Withings WBS01 | Scale| |WS30 | Scale| |Kid Scale | Scale| |Smart Body Analyzer | Scale| |Body+ | Scale| |Body Cardio | Scale| |Body | Scale| |Body Scan | Scale| |Body Pro | Scale| |WBS10 | Scale| |WBS11 | Scale| |Body Comp | Scale| |Smart Baby Monitor | Babyphone| |Withings Home | Babyphone| |Withings Blood Pressure Monitor V1 | Blood Pressure Monitor| |Withings Blood Pressure Monitor V2 | Blood Pressure Monitor| |Withings Blood Pressure Monitor V3 | Blood Pressure Monitor| |BPM Core | Blood Pressure Monitor| |BPM Connect | Blood Pressure Monitor| |BPM Connect Pro | Blood Pressure Monitor| |BPM Pro 2 | Blood Pressure Monitor| |BPM Vision | Blood Pressure Monitor| |Pulse | Activity Tracker| |Activite | Activity Tracker| |Activite (Pop, Steel) | Activity Tracker| |Withings Go | Activity Tracker| |Activite Steel HR | Activity Tracker| |Activite Steel HR Sport Edition | Activity Tracker| |Pulse HR | Activity Tracker| |Move | Activity Tracker| |Move ECG | Activity Tracker| |ScanWatch | Activity Tracker| |ScanWatch 2 | Activity Tracker| |ScanWatch Light | Activity Tracker| |Aura Dock | Sleep Monitor| |Aura Sensor | Sleep Monitor| |Aura Sensor V2 | Sleep Monitor| |Thermo | Smart Connected Thermometer| |BeamO | Smart Connected Thermometer| |WUP01 | Gateway| |iGlucose Plus | Smart Meter| |iGlucose Essential | Smart Meter| |iPulse OX | Smart Meter| |iOS step tracker | HealthKit Apple| |HealthKit step iPhone tracker | HealthKit Apple| |HealthKit step Apple Watch tracker | HealthKit Apple| |HealthKit other step tracker | HealthKit Apple| |Android step tracker | HealthKit Google| |GoogleFit tracker | HealthKit Google| |Samsung Health tracker | HealthKit Google| |Google Health Connect | HealthKit Google| |Huawei tracker | HealthKit Huawei| |Lingo Sensor | Lingo| |WPA02 | Fluid Analyzer|
      - `model_id` integer: | Value | Description| |---|---| |1 | Withings WBS01| |2 | WS30| |3 | Kid Scale| |4 | Smart Body Analyzer| |5 | Body+| |6 | Body Cardio| |7 | Body| |10 | Body Scan| |9 | Body Pro| |11 | WBS10| |12 | WBS11| |18 | Body Comp| |21 | Smart Baby Monitor| |22 | Withings Home| |41 | Withings Blood Pressure Monitor V1| |42 | Withings Blood Pressure Monitor V2| |43 | Withings Blood Pressure Monitor V3| |44 | BPM Core| |45 | BPM Connect| |46 | BPM Connect Pro| |47 | BPM Pro 2| |48 | BPM Vision| |51 | Pulse| |52 | Activite| |53 | Activite (Pop, Steel)| |54 | Withings Go| |55 | Activite Steel HR| |59 | Activite Steel HR Sport Edition| |58 | Pulse HR| |90 | Move| |91 | Move ECG| |92 | Move ECG| |93 | ScanWatch| |94 | ScanWatch 2| |95 | ScanWatch Light| |60 | Aura Dock| |61 | Aura Sensor| |63 | Aura Sensor V2| |70 | Thermo| |71 | BeamO| |100 | WUP01| |1061 | iGlucose Plus| |1065 | iGlucose Essential| |1066 | iPulse OX| |1051 | iOS step tracker| |1052 | iOS step tracker| |1057 | HealthKit step iPhone tracker| |1058 | HealthKit step Apple Watch tracker| |1059 | HealthKit other step tracker| |1053 | Android step tracker| |1054 | Android step tracker| |1055 | GoogleFit tracker| |1056 | Samsung Health tracker| |1060 | Google Health Connect| |1062 | Huawei tracker| |1063 | Lingo Sensor| |102 | WPA02|
      - `battery` string: Battery level: high (> 75%), medium (> 30%) or low
      - `deviceid` string: ID of the device. This ID is returned in other services to know which device tracked a data. Then device's model or type can be known using this information.
      - `timezone` string: Timezone of the device.
      - `last_session_date` integer: The timestamp of the last server connection of the device
      - `serial_number` string: Serial number of the device.

---

[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)