In this guide

List Light Groups

Current light groups and their v2 resource IDs.

Action referenceRead

What this action does #

First, connect Philips Hue in Services. Then open Actions → + → Philips Hue and choose List Light Groups.

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 fieldTypeMeaning
errorsarrayA list of values.
errors[].descriptionstringText value.
errors[].error_codestringText value.
dataarrayA list of values.
data[].idstringText value.
data[].id_v1stringText value.
data[].typestringText value.
data[].ownerobjectA group of named values.
data[].owner.ridstringText value.
data[].owner.rtypestringText value.
data[].onobjectA group of named values.
data[].on.onbooleanTrue or false.
data[].dimmingobjectA group of named values.
data[].dimming.brightnessnumberNumeric value.
data[].alertobjectA group of named values.
data[].alert.action_valuesarrayA list of values.
data[].signalingobjectA group of named values.
data[].signaling.signal_valuesarrayA list of values.

Run it from Shortcuts #

  1. Give the action a recognizable name and tap Save.
  2. In Apple Shortcuts, add Shortcutify’s Execute Action and select the saved action.
  3. 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/grouped_light

Action identifier: philips-hue.grouped_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.

Philips Hue API reference