Skip to main content

Philips Hue API Endpoints

The Philips Hue API endpoints the iPaaS.com integration calls to control lights and groups, plus the OAuth authorization endpoints.

API Endpoints Intro

The Philips Hue integration uses the Philips Hue REST API. Light and group commands are sent to your Bridge through the Hue cloud, using a base URL that includes your authenticated Bridge user:

Base URL: https://api.meethue.com/bridge/{Hue Bridge User}

{Hue Bridge User} is filled in automatically when you authenticate the subscription (see Philips Hue Connections and Settings). The authorization endpoints below use the https://api.meethue.com host directly, without the /bridge/{Hue Bridge User} segment.

Areas covered: Light Endpoints · Group Endpoints · Authorization Endpoints

Light Endpoints

Get all Lights (GET)

[Base URL]/lights

Get a Light by Id (GET)

[Base URL]/lights/{id}

Update Light State (PUT)

[Base URL]/lights/{id}/state

Used to apply a light command (for example, a flash) to a specific light.

Group Endpoints

Get all Groups (GET)

[Base URL]/groups

Update Group Action (PUT)

[Base URL]/groups/{id}/action

Used to apply a light command to a Hue group.

Authorization Endpoints

Philips Hue uses OAuth. These endpoints are called on the https://api.meethue.com host during authentication and token renewal.

Get Access Token (POST)

https://api.meethue.com/oauth2/token

Refresh Access Token (POST)

https://api.meethue.com/oauth2/refresh

Register a Bridge Application (POST)

https://api.meethue.com/bridge

Called during the initial connection to authorize iPaaS.com with your Hue Bridge.

Configure the Bridge (PUT)

https://api.meethue.com/bridge/0/config

Called during the initial connection to complete the Bridge authorization.

Related Documents

External References

Did this answer your question?