Send Notification
pushcut.send_notification
ActionChat & messagingconnection required
Calls the Pushcut API with the connection's credentials.
Send one of the notifications defined in the Pushcut app to your iOS devices, overriding its title, text, sound, image or actions.
Connection
- Required
- Yes — the node will not save without one
- Auth type
- API key
- Providers
- Pushcut
- Secret shape
- the API key, or {"api_key": "…"}
- Config it needs
- server_id
- Resolved by
- config.connection_id, else node.connection_id
Configuration
13 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 |
|---|---|---|---|---|---|
notification_name Name of the notification as defined in the Pushcut app. | string | Yes | — | — | MyNotification |
title Title shown on the device, replacing the one defined in the app. | string | No | — | — | — |
text Body text shown on the device, replacing the one defined in the app. | string | No | — | — | — |
input Value passed as the input to the notification's action. | string | No | — | — | — |
sound Sound to play. The built-in names are none, vibrateOnly, system, subtle, question, jobDone, problem, loud and lasers; a sound imported into the app is named directly. | string | No | — | — | subtle |
image Name of an image imported into Pushcut, or an https URL to one. | string | No | — | — | MyFunnyNotificationImage |
devices Names of the devices to act on; leave empty for every active device. | array | No | — | array of string | ["Simon's iPhone"] |
actions Dynamic actions merged with the ones defined in the app. Each needs a 'name' and may carry a url, shortcut, homekit or online action to run. | array | No | — | array of object | [{"name":"Open Website","url":"https://www.pushcut.io"}] |
delay Schedule the notification this far out instead of sending it now, as a duration such as 10s, 15m or 6h. Needs a Pushcut Extended subscription. | string | No | — | — | 10s |
schedule_timestamp Unix timestamp in milliseconds at which the notification should fire. | number | No | — | ≥ 0 | — |
interruption_level How insistently iOS should present the notification. | string | No | — | one of "active", "passive", "timeSensitive" | — |
thread_id Thread id iOS groups related notifications under. | string | No | — | — | — |
notification_id Unique id for this notification. Sending again with the same id replaces the notification already on the device. | string | No | — | — | 1snurqjF5vLxoUq09Q358 |
Example configuration
Every value below is the contract’s own example or default — nothing invented.
{
"actions": [
{
"name": "Open Website",
"url": "https://www.pushcut.io"
}
],
"delay": "10s",
"devices": [
"Simon's iPhone"
],
"image": "MyFunnyNotificationImage",
"notification_id": "1snurqjF5vLxoUq09Q358",
"notification_name": "MyNotification",
"sound": "subtle"
}Output
One shape.
result
| Field | Type | Example |
|---|---|---|
id Pushcut's id for the notification that was submitted. | string | — |
notification The notification definition that was sent. | string | — |
scheduled True when Pushcut scheduled the notification instead of delivering it. | boolean | — |
scheduleTimestamp Unix timestamp in milliseconds it is scheduled for; null when sent now. | number | — |
{
"id": "",
"notification": "",
"scheduleTimestamp": 0,
"scheduled": false
}See Send Notification run in a workflow.
In a technical demo we add the Pushcut connection, drop the node on the canvas and let Workflow Health pre-flight it before the first real run.