Pushcut integration

What it does

The Pushcut integration lets your agency drive a client's iPhone and iPad automation from inside a workflow, and lets taps on those devices drive workflows back. Connect a client's Pushcut account once and your workflows can send rich iOS notifications (custom title, body, sound, image, action buttons, Time-Sensitive delivery and threading), update home-screen widgets, have the Pushcut Automation Server run Siri Shortcuts or set HomeKit scenes now or on a delay, and cancel a scheduled run. The Online Action Executed trigger closes the loop: add the online action to a notification button or widget, and every tap starts a workflow run with the value that was passed along.

Connect a Pushcut account

1. Open your workspace in TaskJuice and navigate to Connections.
2. Choose Pushcut and click Connect.
3. On the client's iPhone or iPad, open the Pushcut app and tap Account, then Integrations, then API.
4. Tap Create API Key, name it (for example TaskJuice), and copy the generated key.
5. Paste the key into TaskJuice. The key is sent on the API-Key header on every request.

To rotate or revoke the key, return to the Pushcut app, delete the existing key, generate a new one, and update the TaskJuice connection.

Triggers

• pushcut/action-executed (Online Action Executed) fires when someone runs a named Pushcut online action: from a notification button, a widget, a Shortcut, or the Pushcut app. The payload carries the event id, the action name, the input passed with the action, and a timestamp.

TaskJuice sets the online action up for you. Type a unique name for the action in the trigger's Online action name field and publish the workflow. TaskJuice registers the online action on the connected Pushcut account, where it appears as a server action you can attach to notification buttons and widgets. Unpublishing the workflow removes it. Each published trigger needs its own action name.

Actions

• pushcut/send-notification sends a predefined Pushcut notification by name, now or on a delay or schedule. Overrides the title, body, input string, default action, dynamic action buttons, image, sound, target devices, Time-Sensitive flag, and thread ID at send time. Give it a Notification ID to update or cancel it later.
• pushcut/cancel-notification cancels a delayed or scheduled notification by its Notification ID.
• pushcut/execute-action (Execute Automation Server Action) runs a Siri Shortcut or sets a HomeKit scene on the account's Automation Server, picked from dropdowns, with an optional input, timeout, delay, and identifier for scheduled runs.
• pushcut/cancel-execution cancels a delayed Automation Server run by the identifier it was scheduled with.
• pushcut/update-widget updates a home-screen widget: switch the content it shows, pass new values into its input markers, and set what tapping it does, on all devices or a chosen few.
• pushcut/list-devices lists the iOS devices registered on the connected account, so workflows can target a device by name.
• pushcut/list-notifications lists the notification templates defined on the connected account.
• pushcut/list-shortcuts lists the Siri Shortcuts the Automation Server can run.
• pushcut/list-homekit-scenes lists the HomeKit scenes the Automation Server can set.
• pushcut/list-subscriptions lists the online actions registered on the account and the URLs they call.

Known limitations

• Pushcut is an iOS-only product. The connected account must have at least one iPhone or iPad running the Pushcut app for notifications and widget updates to deliver.
• Dynamic notification titles, text, images and inputs, and all widgets, need a Pushcut Pro subscription on the connected account.
• Notification templates and widgets are designed inside the Pushcut app, not through the API. Send Notification and Update Widget target an existing template or widget by name, so create it on a device first.
• Automation Server actions need a dedicated, awake iOS device with Automation Server running. When none is running, Pushcut answers with an error that TaskJuice surfaces as a retryable provider error. Delayed runs (the Delay field) need an Automation Server Extended subscription; without it Pushcut rejects the request as payment required.
• Pushcut does not sign the requests it sends when an online action runs. TaskJuice gives every registration its own unguessable delivery URL, and that URL is the only credential, so treat the action name and URL as private.
• The API key has full account scope. Treat it as a high-privilege secret and rotate it from the Pushcut app when team members change.