WIwithings
user

User v2 - Link

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 for more information on device authorization.
posthttps://wbsapi.withings.net/v2/user

Request

  • Base URL
    https://wbsapi.withings.net
  • Auth
    none declared. Required headers: Authorization

Query parameters

actionstring required

Service action name. Must take the string value link.

mac_addressesunknown required

List of Withings device MAC addresses that will be linked to the created user. Example: ["00:24:e4:xx:xx:xx","00:24:e4:xx:xx:xx"]

Headers

Authorizationstring required

Used to pass your access token. Must take value: Bearer {your access_token} Replace {your access_token} with the access_token

Response

(Click to unfold)

statusinteger

Response status. See <a href='#tag/response_status'>Status</a> section for details.

Example response

{
  "body": {
    "devices": [
      {
        "mac_address": "00:24:e4:69:b2:30",
        "type": "Scale",
        "model": "Body Cardio",
        "model_id": 6,
        "battery": "medium",
        "deviceid": "892359876fd8805ac45bab078c4828692f0276b1",
        "timezone": "Europe/Paris",
        "last_session_date": 1594159644,
        "serial_number": "SN-001122334455"
      }
    ]
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.