PushcutURL Scheme
Pushcut has its own URL Scheme so you can jump straight to specific pages, and more.
Pushcut's URL scheme starts with pushcut://.
Open Page
To open Pushcut, you can use pushcut://open/, and then add the name of the view you want to open1:
Actions
Pushcut also supports running actions directly via URL scheme. These actions support x-callback-url, so you can chain them into Shortcuts or other automation apps and receive the result when the action completes.
All action URLs follow the form:
pushcut://x-callback-url/<action>?name=<name>&x-success=<url>&x-error=<url>
On success, the callback URL receives a result parameter. On error, the standard x-error callback is called with an errorMessage parameter.
runServerAction
Runs a server action on your Automation Server. The action executes on the server device, not your local device.
pushcut://x-callback-url/runServerAction?name=<action-name>
| Parameter | Description |
|---|---|
name |
The name of the server action to run |
input |
Optional input string passed to the shortcut or HomeKit action |
x-success |
Called when the action completes; receives result with any return value from the shortcut |
x-error |
Called on failure |
x-cancel |
Called if the action is cancelled |
runIntegration
Triggers an integration, running all connected webhooks or online service actions.
pushcut://x-callback-url/runIntegration?name=<integration-name>
| Parameter | Description |
|---|---|
name |
The name of the integration to trigger |
x-success |
Called when the trigger completes; receives result
|
x-error |
Called on failure |
runHomeKitScene
Sets a HomeKit scene.
pushcut://x-callback-url/runHomeKitScene?name=<scene-name>
| Parameter | Description |
|---|---|
name |
The name of the HomeKit scene (use Home: Scene for scenes in a specific home) |
x-success |
Called when the scene is set; receives result
|
x-error |
Called on failure |
updateWidget
Updates a widget with new content.
pushcut://x-callback-url/updateWidget?name=<widget-name>&content=<new-content>
| Parameter | Description |
|---|---|
name |
The name of the widget to update |
content |
The new content to use for this widgt |
input |
The input to provide to the new content |
x-success |
Called when the widget is updated; receives result
|
x-error |
Called on failure |
-
All of the words above are URL schemes you can use to test this, or copy to use. ↩