In this guide
List Lights
Current lights and their v2 resource IDs.
What this action does #
First, connect Philips Hue in Services. Then open Actions → + → Philips Hue and choose List Lights.
Inputs to fill in #
This action has no input fields. You can name and save it after choosing the action.
What comes back #
In the action editor, open Output → Returned Value to choose fields for your shortcut. These are the response fields described by the app; a service may omit an optional field or return an empty list. JSON File contains the full response.
| Returned field | Type | Meaning |
|---|---|---|
errors | array | A list of values. |
errors[].description | string | Text value. |
errors[].error_code | string | Text value. |
data | array | A list of values. |
data[].id | string | Text value. |
data[].id_v1 | string | Text value. |
data[].type | string | Text value. |
data[].owner | object | A group of named values. |
data[].owner.rid | string | Text value. |
data[].owner.rtype | string | Text value. |
data[].metadata | object | A group of named values. |
data[].metadata.name | string | Text value. |
data[].metadata.archetype | string | Text value. |
data[].services | array | A list of values. |
data[].services[].rid | string | Text value. |
data[].services[].rtype | string | Text value. |
data[].on | object | A group of named values. |
data[].on.on | boolean | True or false. |
data[].dimming | object | A group of named values. |
data[].dimming.brightness | number | Numeric value. |
data[].dimming.min_dim_level | number | Numeric value. |
data[].color | object | A group of named values. |
data[].color.xy | object | A group of named values. |
data[].color.xy.x | number | Numeric value. |
data[].color.xy.y | number | Numeric value. |
data[].color.gamut_type | string | Text value. |
data[].color.gamut | object | A group of named values. |
data[].color.gamut.red | object | A group of named values. |
data[].color.gamut.red.x | number | Numeric value. |
data[].color.gamut.red.y | number | Numeric value. |
data[].color.gamut.green | object | A group of named values. |
data[].color.gamut.green.x | number | Numeric value. |
data[].color.gamut.green.y | number | Numeric value. |
data[].color.gamut.blue | object | A group of named values. |
data[].color.gamut.blue.x | number | Numeric value. |
data[].color.gamut.blue.y | number | Numeric value. |
data[].color_temperature | object | A group of named values. |
data[].color_temperature.mirek | integer | May be null when the light is outside the white temperature spectrum. |
data[].color_temperature.mirek_valid | boolean | True or false. |
data[].color_temperature.mirek_schema | object | A group of named values. |
data[].color_temperature.mirek_schema.mirek_minimum | integer | Whole-number value. |
data[].color_temperature.mirek_schema.mirek_maximum | integer | Whole-number value. |
data[].dynamics | object | A group of named values. |
data[].dynamics.status | string | Text value. |
data[].dynamics.speed | number | Numeric value. |
data[].dynamics.speed_valid | boolean | True or false. |
data[].dynamics.status_values | array | A list of values. |
data[].effects_v2 | object | A group of named values. |
data[].effects_v2.action | object | A group of named values. |
data[].effects_v2.action.effect_values | array | A list of values. |
data[].effects_v2.status | object | A group of named values. |
data[].effects_v2.status.effect | string | Text value. |
data[].effects_v2.status.effect_values | array | A list of values. |
data[].mode | string | Text value. |
Run it from Shortcuts #
- Give the action a recognizable name and tap Save.
- In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
- Supply any Param or File slots you bound in the inputs, then run the shortcut.
If the result is unexpected, open Logs in Shortcutify, select the run, and inspect this step’s inputs and response.
Advanced reference #
Request, permissions, and identifiers
Request: GET https://api.meethue.com/route/clip/v2/resource/light
Action identifier: philips-hue.light.list.v1
No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.