Skip to content

Flows Actions Retrieve Insight value by text

Arie J. Godschalk edited this page Nov 15, 2026 · 1 revision

Retrieve Insight Log Value (text inputs)

App Flowcards · Actions index

Read Insight history when device and capability names or IDs are supplied as text or Flow tags.

Before you start

Select the exact device, app, zone, capability, or saved AVD field that the card should use. When a card changes device state, test it on a non-critical device first.

Card settings

  • Device (tag/text) (text input) — Choose the device this card works with.
  • Capability (tag/text) (text input) — Choose a capability offered by the selected device.
  • Numberof (number input) — Enter the minutes to look back; 0 requests the latest recorded value.

Output tokens

  • Device (string) — The device name used for the Insight lookup.
  • Capability (string) — The capability ID used for the Insight lookup.
  • User (string) — The Homey user who changed the value, when Homey records it.
  • Client (string) — The app/client that changed the value, when Homey records it.
  • Number (number) — The numeric Insight value, when the recorded value is numeric.
  • Yes/No (boolean) — The Yes/No Insight value, when the recorded value is Boolean.
  • Changed on (UTC) (string) — The recorded change time in UTC.
  • Changed on (UTC tick) (number) — The recorded time as a UTC tick value.
  • Duration till now (Milliseconds) (number) — Elapsed time since the recorded change, in milliseconds.

A token is a value produced by a Flow card. Connect it from this card to the matching input on a later card instead of copying a live value by hand.

How it works and limits

Set minutes to 0 for the latest entry. The capability still needs Homey Insight history. Output tokens match the selector-based version.

Example

Enter the exact device name and capability ID for an item with Insight history, set minutes to 0, and connect Number to a later numeric input. Confirm that the lookup identifies the intended record.

Related

General Flow guide · Troubleshooting

Clone this wiki locally