In this guide

Get Light Level Sensor Details

State and supported features of a light level sensor.

Action referenceRead

What this action does #

First, connect Philips Hue in Services. Then open Actions → + → Philips Hue and choose Get Light Level Sensor Details.

Inputs to fill in #

Open an input to choose its value. Keep a fixed value with Text, receive it from Shortcuts, ask when the action runs, or use an Earlier Step. Read how input sources work.

Light Level Sensor

RequiredText

Choose the named v2 resource. V1 numeric IDs cannot be used here.

This input offers a picker for light level sensor from your connected account. You can also supply its value directly.

Example value (replace with your own):

fc2daa74-0d44-4712-a373-e39a9c2b426d

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[].enabled`	boolean	True or false.
`data[].light`	object	A group of named values.
`data[].light.light_level`	integer	Legacy logarithmic light level.
`data[].light.light_level_valid`	boolean	True or false.
`data[].light.light_level_report`	object	A group of named values.
`data[].light.light_level_report.changed`	string	Text value.
`data[].light.light_level_report.light_level`	integer	10000 × log10(lux) + 1; this is not a raw lux 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_level/{id}

Action identifier: philips-hue.light_level.get.v1

No additional per-action permissions are declared in the app’s catalog. The integration’s connection and account access rules still apply.

Input	Request key	Location
Light Level Sensor	`id`	path

Philips Hue API reference