Send a notification
services_send_notificationSend push notifications to a person or device through a Home Assistant notify service. Specify a message, optional title, and target channel.
Instructions
Send a notification through a Home Assistant notify service.
Calls notify.<target> (or plain notify.notify when target is
omitted) with message and optional title; target may include the
domain (notify.xyz) or be a bare service name, but a dotted target
must name the notify domain itself (ADR-0006 D6) — otherwise it would
let any domain.service be reached under cover of a "notification".
Each call dispatches a new notification to whatever device or channel
that service delivers to, which can be outside the local network (e.g.
a phone push).
Use when: pushing a message to a person or device through a configured
notify service.
Not for: an in-UI banner tracked by an ID — use
services_notify_persistent_create.
Returns: the list of states changed by the call (notify services
typically change none).
Errors: {"error": "invalid_notify_target", "message": ...} when a
dotted target names a domain other than notify; {"error": "invalid_service_name"} when the part after notify. is not itself a
bare [A-Za-z0-9_]+ service name (e.g. a second dot).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | Optional notification title. Omit for no title. | |
| target | No | Notify service to use, e.g. 'mobile_app_phone' or 'notify.mobile_app_phone'. Omit to use the default 'notify' service. | |
| message | Yes | Notification body text to deliver. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |