In this guide

Philips Hue

Read and control lights, rooms, and scenes through your Hue Bridge’s internet connection.

Integration guideHue Bridge, Hue account, Client ID and Client secret

What you can do #

This integration uses Hue’s remote service. You need a Hue Bridge connected to the internet and linked to your Hue account. Bluetooth-only lights cannot use it.

You can list lights and rooms, read supported features, change a light’s power or brightness, recall a scene, and read sensor values. A room and the group of lights that belongs to it are different resources; use the picker for the input you are setting.

Connect Philips Hue #

  1. In the Philips Hue app, confirm your Bridge is linked to your Hue account and has internet access.
  2. At Hue’s developer portal, add a Remote Hue API app. Set its Callback URL to the exact redirect address below.
  3. Copy its Client ID and Client secret. In Shortcutify, open Services → Philips Hue and fill in both fields.
  4. Tap Connect Philips Hue and sign in to your Hue account. Shortcutify completes the remote bridge-key setup after authorization.

You do not need to press the physical Bridge button for this remote setup. A client secret is a credential from your developer app; it is different from your Hue account password. Hue’s remote setup reference may require a developer sign-in.

https://auth.getshortcutify.app/oauth/philips-hue

Example: see the lights your Bridge exposes #

  1. In Actions, tap +, choose Philips Hue, then List Lights.
  2. This read action has no input fields to fill in. Name and save it.
  3. Use Execute Action in Apple Shortcuts to run the saved action. Select returned fields in Shortcutify if you only want part of the list.

To control a light, create a separate action such as Set Light On or Off and use its light picker to select the light. Testing a control action changes the real light’s state.

Brightness and power are separate

A brightness of 0 means minimum brightness, not off. Use the power action to turn a light off. Color and effects depend on what the selected light supports.

If something does not work #

I only have Bluetooth lights

This integration needs a Hue Bridge linked to your account. It cannot connect directly to Bluetooth-only lights.

A color or effect does not work

Check Get Light Details to see what the chosen light supports. The presence of a control action does not mean every light supports that feature.

Which temperature unit should I enter?

The color-temperature action uses mirek, not Kelvin. The input reference shows the accepted range; the individual light can support a narrower range.

Hue reports a communication error

Check the light’s power, Bridge connection, and internet access. The remote integration needs Hue’s cloud service to reach your Bridge.

All Philips Hue actions #

These are the actions available in the app’s request picker. Open one for its inputs, returned fields, and permissions.

List All Resources

All current v2 resources, including names, owners and service references.

Read

List Lights

Current lights and their v2 resource IDs.

Read

Get Light Details

State and supported features of a light.

Read

List Light Groups

Current light groups and their v2 resource IDs.

Read

Get Light Group Details

State and supported features of a light group.

Read

List Rooms

Current rooms and their v2 resource IDs.

Read

Get Room Details

State and supported features of a room.

Read

List Zones

Current zones and their v2 resource IDs.

Read

Get Zone Details

State and supported features of a zone.

Read

List Scenes

Current scenes and their v2 resource IDs.

Read

Get Scene Details

State and supported features of a scene.

Read

List Devices

Current devices and their v2 resource IDs.

Read

Get Device Details

State and supported features of a device.

Read

List Bridges

Current bridges and their v2 resource IDs.

Read

Get Bridge Details

State and supported features of a bridge.

Read

List Motion Sensors

Current motion sensors and their v2 resource IDs.

Read

Get Motion Sensor Details

State and supported features of a motion sensor.

Read

List Temperature Sensors

Current temperature sensors and their v2 resource IDs.

Read

Get Temperature Sensor Details

State and supported features of a temperature sensor.

Read

List Light Level Sensors

Current light level sensors and their v2 resource IDs.

Read

Get Light Level Sensor Details

State and supported features of a light level sensor.

Read

List Device Batteries

Current device batteries and their v2 resource IDs.

Read

Get Device Battery Details

State and supported features of a device battery.

Read

Set Light On or Off

Set Light On or Off using the selected light.

Change

Set Light Brightness

Set Light Brightness using the selected light.

Change

Set Light Color

Set Light Color using the selected light.

Change

Set Light Color Temperature

Set Light Color Temperature using the selected light.

Change

Alert Light

Alert Light using the selected light.

Change

Set Group On or Off

Set Group On or Off using the selected light group.

Change

Set Group Brightness

Set Group Brightness using the selected light group.

Change

Set Group Color

Set Group Color using the selected light group.

Change

Set Group Color Temperature

Set Group Color Temperature using the selected light group.

Change

Alert Group

Alert Group using the selected light group.

Change

Recall Scene

Recall Scene using the selected scene.

Change

Set Light Effect

Set Light Effect using the selected light.

Change

Service setup references #

The service controls its account requirements and permissions. These references explain its setup in more detail.