Philips Hue: Turn Light On/Off
Turn a Philips Hue light or group of lights on or off. Accepts both v1 IDs (e.g., '81', '0') and v2 UUIDs (e.g., '2ec2b2f1-...'). At least one of lightId or groupId must be provided. Ideal for: automation, scheduling, presence detection, notifications.
Catalog action Integrations pipedream:philips_hue
Turn a Philips Hue light or group of lights on or off. Accepts both v1 IDs (e.g., '81', '0') and v2 UUIDs (e.g., '2ec2b2f1-...'). At least one of lightId or groupId must be provided. Ideal for: automation, scheduling, presence detection, notifications.
At a Glance
| Field | Value |
|---|---|
| Action ID | philips-hue-turn-light-on |
| Category | Integrations |
| Connector | pipedream:philips_hue |
| Requires gas | No |
| Funds movement | None declared |
| Tags | pipedream, integration, oauth, philips-hue, smart-home, lights |
Payload Schema
| Field | Type | Required | Description |
|---|---|---|---|
lightId | string | No | ID of the light to control. Accepts v1 IDs (e.g., '3') or v2 UUIDs (e.g., 'a1b2c3d4-...'). At least one of lightId or groupId must be provided (mutually exclusive). |
groupId | string | No | ID of the light group to control. Accepts v1 IDs (e.g., '81', '0') or v2 UUIDs (e.g., '2ec2b2f1-...'). At least one of lightId or groupId must be provided (mutually exclusive). |
turnLightOff | boolean | No | Set to true to turn light(s) off, false or omit to turn on |
Result Schema
| Field | Type | Required | Description |
|---|---|---|---|
success | boolean | Yes | Whether the action succeeded |
data | object | No | Response from Philips Hue API |
Examples
json{ "type": "philips-hue-turn-light-on", "payload": { "lightId": "example-lightId", "groupId": "example-groupId", "turnLightOff": false }, "children": [], "connector": { "type": "pipedream:philips_hue", "id": "conn_pipedream_philips_hue" }}
bashcurl -X POST "https://api.b3os.org/v1/actions/philips-hue-turn-light-on/test" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "inputs": { "lightId": "example-lightId", "groupId": "example-groupId", "turnLightOff": false }}'
Payload fields can use workflow expressions such as {{$trigger.body.amount}}, {{$nodes.fetch.result.price}}, and {{$props.asset}} when the value should come from a trigger, prior node, or reusable workflow prop.