Authentication

The authentication API allows to retrieve the hue-application-key, that is passed as header for Authorization.

Authenticate

Authenticate to retrieve the HUE application key. Requires to go and press the button on the bridge

POSThttps://192.168.1.0/api

Body

application/json

devicetypestring

generateclientkeyboolean

Response

200401

Authentication Success

Body

application/json

successobject

errorobject

Request

JavaScriptCurl

const response = await fetch('https://192.168.1.0/api', {
    method: 'POST',
    headers: {
      "Content-Type": "application/json"
    },
    body: JSON.stringify({}),
});
const data = await response.json();

Response

[
  {
    "success": {
      "username": "text",
      "clientkey": "text"
    },
    "error": {
      "type": 101,
      "address": "text",
      "description": "link button bot pressed"
    }
  }
]

You absolutely need to press the button on your Hue bridge before calling this endpoint. Otherwise, the response will contain the message "link button not pressed".

This is a security step so that only apps you want to control your lights can. By pressing the button, you prove that you have physical access to the bridge.