Send Notification
pushover.send_message
ActionChat & messagingconnection required
Calls the Pushover API with the connection's credentials.
Push a notification to a Pushover user or group, choosing its priority, sound and how long it stays on the device.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Pushover
- Secret shape
- the application API token, or {"token": "…"}
- Config it needs
- user_key
- Resolved by
- config.connection_id, else node.connection_id
Configuration
16 fields, 1 required. A dotted path is a nested object and name[] an array of objects — the editor renders the same tree.
| Field | Type | Required | Default | Constraints | Example |
|---|---|---|---|---|---|
message The body of the notification, at most 1024 characters. | string | Yes | — | ≤ 1024 characters | — |
title Title shown above the message; defaults to the application's name. | string | No | — | ≤ 250 characters | — |
user Recipient user or group key; overrides the connection's default recipient. | string | No | — | — | uQiRzpo4DXghDmr9QzzfQu27cmVRsG |
device Name of one device to deliver to, or several separated by commas. Leave blank to reach every device on the account. | string | No | — | — | iphone |
priority How insistently to deliver: -2 badge only, -1 quiet, 0 normal, 1 bypasses quiet hours, 2 repeats until acknowledged. | number | No | 0 | -2–2 | — |
sound Name of the sound to play, such as pushover, siren, magic or none. Run pushover.list_sounds for the names this application accepts, including any custom ones. | string | No | — | — | pushover |
url Supplementary link shown with the message, at most 512 characters. | string | No | — | ≤ 512 characters; url format | — |
url_title Text to show instead of the raw link, at most 100 characters. | string | Conditional | — | ≤ 100 characters; only with url | — |
html Render a small set of HTML tags in the message instead of plain text. | boolean | No | false | — | — |
monospace Render the message in a monospace font. | boolean | No | false | — | — |
timestamp Unix timestamp to show as the message's time; defaults to now. | number | No | — | ≥ 0 | — |
ttl Seconds after which the notification is deleted from the device. Ignored for emergency-priority messages. | number | No | — | ≥ 1 | — |
retry Emergency priority only: how often to repeat the notification, in seconds, and at least 30. | number | Conditional | — | ≥ 30; only with priority | — |
expire Emergency priority only: how long to keep repeating, in seconds, and at most 10800 (three hours). | number | Conditional | — | 30–10800; only with priority | — |
callback Emergency priority only: a public URL Pushover POSTs to once someone acknowledges the notification. | string | Conditional | — | url format; only with priority | — |
tags Comma-separated tags for this message, so a later pushover.cancel_receipts_by_tag can stop all of their repeats. | string | No | — | — | incident-42 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"device": "iphone",
"html": false,
"monospace": false,
"priority": 0,
"sound": "pushover",
"tags": "incident-42",
"user": "uQiRzpo4DXghDmr9QzzfQu27cmVRsG"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
request Pushover's unique id for this API request. | string | — |
receipt Receipt id for an emergency-priority message; empty for every other. | string | — |
priority The priority the message was sent at. | number | — |
status Pushover's status field; 1 when the message was sent. | number | — |
{
"priority": 0,
"receipt": "",
"request": "",
"status": 0
}See Send Notification run in a workflow.
In a technical demo we add the Pushover connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.