Reference · Tools
Pushcut Trigger
Starts workflow when Pushcut events occur
The Pushcut Trigger starts a workflow when someone runs a server action from the Pushcut iOS app — by tapping it in a notification or launching it directly. The action context arrives as the payload. A typical build is a phone-tap that kicks off a backend job without opening a laptop.
- Node type
- Webhook trigger
- Parameters
- 1
- Outputs
- Output
- Credentials
- Pushcut
Pushcut Trigger
Triggers when a Pushcut server action is executed from an iOS device
Overview
Receives webhook notifications from Pushcut when a user triggers a server action from the Pushcut iOS app. Pushcut is an iOS automation app that sends smart notifications with custom actions. When a server action is tapped in the app, Pushcut sends a POST request to the registered webhook URL with the action context payload. The trigger registers a subscription with the Pushcut API using a user-defined action name, which then appears as a server action in the Pushcut iOS app. The entire incoming request body is captured and forwarded as the trigger output. Useful for building mobile-triggered automations, remote server controls, iOS shortcut integrations, and notification-driven workflows.
Category: Utility
Tool Name: pushcut_trigger
Version: 1
Appearance: Icon: lucide-Smartphone | Color: #ce3e00
Node Type
Trigger — webhook (receives incoming HTTP callbacks)
Input / Output
| Direction | Port(s) |
|---|---|
| Input | None (trigger node) |
| Output | Output |
Credentials
This tool requires Pushcut credentials. See the Credentials Guide for setup instructions.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
| Action Name | string | No | — | Choose any name you would like. It will show up as a server action in the Pushcut iOS app. |
Output Data
Each incoming Pushcut request produces one output item. The item carries three metadata fields, and the request body is merged in at the top level:
_trigger— alwayspushcut_webhook_timestamp— ISO 8601 timestamp of when the request arrived_webhookEvent— alwaysaction_triggered
Everything Pushcut sends in the body (for example the action name, any text you typed into the notification, and the device list) sits alongside those fields. Reference it downstream by expression, e.g. {{ $json.actionName }}.
Usage Examples
- Start a workflow when a Pushcut notification action is tapped on iPhone
- Trigger a server task from an iOS shortcut via Pushcut
- Run a home automation routine from a Pushcut notification
- Execute a deployment script when a Pushcut server action is triggered
Example Configuration
Register a server action named “Deploy Production”:
{
"type": "pushcut_trigger",
"parameters": {
"actionName": "Deploy Production"
}
}
Register a server action for a home automation routine:
{
"type": "pushcut_trigger",
"parameters": {
"actionName": "Evening Routine"
}
}
Trigger Behavior
- Activation: When the workflow is activated, a webhook endpoint is registered with the service.
- Deactivation: The webhook is automatically unregistered when the workflow is deactivated.
- Payload: The incoming webhook payload is parsed and output as workflow items.
- Verification: Supports signature verification where applicable.
Tips
Entry point that fires when a Pushcut server action is triggered from the iOS app. Configure the Action Name parameter — this name will appear as a server action in the Pushcut app. When a user taps the action in a notification or runs it from the app, Pushcut sends a POST request to this webhook with the action context payload.
Frequently asked questions
How does the action appear on my phone?
Configure the Action Name and that name shows as a server action inside the Pushcut app, ready to tap or invoke.
What arrives in the workflow?
A POST carrying the action context payload, so any values Pushcut attaches to the invocation come through with it.
How does it pair with the Pushcut action node?
Naturally: use this node to start work from a tap, and the action node to send the notification that offers the tap in the first place.
Which credential does it need?
A Pushcut credential.
Build with the Pushcut Trigger node
Drop it into a workflow, wire it to an agent, or call it on a schedule. You'll need Pushcut credentials first.
Open BusyBotLast updated . Spotted something wrong? Tell us.