Notify
Category: Action
Sends a push notification to your devices when an automation runs.
Push is Homecast Cloud only. In the Community Edition, Notify shows a banner on the relay Mac and nothing else.
When to use
- Alert when a door is opened while you're away
- Notify when temperature exceeds a safe range
- Confirm that an automation completed successfully
- Send a summary of daily device activity
Configuration
- Message — The notification body text. Supports template expressions:
{{ trigger.to_value }}— include the value that triggered the automation{{ nodes.http1.data.body.weather }}— include data from upstream nodes
- Title (optional) — The notification title/heading
- Icon (optional) — The picture on the notification, so you can tell at a glance which automation spoke. Three choices:
- None — no icon
- Predefined — pick a glyph from the grid (leak, door, alert, battery…) and one of 8 tile colours. Colour is worth using deliberately: red for alerts, amber for warnings, green for confirmations
- Custom — an https URL, which supports template expressions, e.g.
{{ nodes.snapshot.data.url }}to show the camera frame from an upstream HTTP node. Custom images aren't recoloured
Delivery
- Push — native macOS/iOS (via APNs) and Android (via FCM) Homecast apps
- Relay alert — macOS notification banner on the relay Mac; if the relay is offline from the cloud, it still banners locally
Each device controls its own notifications, on that device: a master toggle in Settings > Notifications, and a toggle per home and per automation that sends notifications in Settings > Homes > [home] > Notifications. Turning something off mutes it for that device only — other devices and home members are unaffected, and the automation keeps running.
Push goes to you and to home members who have accepted their invitation, on every device where they've installed the Homecast app and allowed notifications. Browsers don't receive push, and there is no email channel.
How the icon appears per channel
- Relay alert (macOS) — a thumbnail beside the banner. Built-in icons are drawn on the Mac itself, so they show instantly and work with no internet.
- iPhone / Mac push — a thumbnail beside the banner.
The Homecast icon stays
Your icon appears alongside the Homecast app icon, not instead of it. Apple draws the app icon itself and gives no way to replace or hide it on a notification — the icon you choose occupies the trailing thumbnail slot. This is why colour is useful: it's what makes one notification distinguishable from another at a glance.
- Android — the expanded notification's large picture. This is the only image hook Android exposes to a URL; the small status-bar icon is always the Homecast icon. A photo (like a camera snapshot) suits this better than a glyph.
An icon is decoration, never a gate: if a custom URL is unreachable, slow, or isn't an image, the notification is still delivered — just without it.
Rate limits
- 30 push/hour per automation
- 200 push/day per user
Output data
{{ nodes['<id>'].data.message }}— The resolved message that was sent{{ nodes['<id>'].data.title }}— The resolved title{{ nodes['<id>'].data.icon }}— The resolved icon (slug or URL){{ nodes['<id>'].data.success }}—trueif the action ran without error{{ nodes['<id>'].data.delivered }}—trueif something actually reached a device{{ nodes['<id>'].data.channels }}— Which channels sent, e.g.['push']or['local']{{ nodes['<id>'].data.rateLimited }}—trueif a rate limit suppressed the send{{ nodes['<id>'].data.reason }}— Why nothing was delivered:rate_limited,no_devices,muted,error
success and delivered are different facts: a rate-limited notification is a successful action that reached nobody.
Examples
Temperature alert with value:
- Device Changed → thermostat, temperature above 30
- Notify → title "Temperature Alert", message "Living room is {{ trigger.to_value }}°C"
Door opened notification:
- Device Changed → front door sensor,
contact_stateto1 - Notify → icon "Door open", message "Front door was opened at {{ now().hour }}:{{ now().minute }}"
Camera snapshot on motion:
- Device Changed → motion sensor
- HTTP Request → fetch a snapshot URL from your camera
- Notify → icon
{{ nodes.http1.data.body.url }}, message "Motion at the front door"
Tips
- Template expressions in the message and the icon URL are resolved at send time — use them to include dynamic values
- Give related automations the same icon and different ones to unrelated alerts; the icon is what makes a notification recognisable before you read it
- Custom icon URLs must be
httpsand publicly reachable — the notification is fetched by your phone or Mac, not by the Homecast server, so a URL that only resolves on your LAN won't load on mobile data - Install the Homecast app on each device that should receive push, and check Settings > Notifications on that device
- For critical alerts, consider also setting a device (e.g. flashing a light) as a backup