Orchestro icon

Orchestro

Orchestro node for n8n

Actions2

Approve

AI-generated

Summary

Send an approval request notification to specified devices via the Orchestro app. Requires device identifiers (at least one), title, and body. Configure review content using markdown, a list of blocks (text, image, link, etc.), or none. Set up approval and refinement actions with custom button labels and required webhook URLs (both must be provided). When a user taps a button, the corresponding webhook is triggered. Returns input items augmented with notification details and API responses for each device.

Inputs

  • userIds (required) — Collection of device identifiers (strings). At least one required.
  • title — Headline of the notification.
  • body — Main message of the notification.
  • reviewContentType — Format of review content: 'markdown', 'list', or 'none'. Default: 'markdown'. Conditional properties: reviewContentMarkdown (if markdown) or reviewContentElements (if list).
  • approvalActions — Configures approval and refinement actions. Each requires a label (string, defaults: 'Approve'/'Refine') and a webhook URL (string, required). Both URLs must be non-empty.

Output shape

Each input item is returned with added fields: title, body, executionId, workflowId, userIds, payload (object with type 'approval', approvalActions, and elements), and responses (array of objects per device containing userId and response/error).

The node makes a POST request to https://orchestro.app/api/push/{userId} for each device identifier. If continueOnFail is false, any error stops execution; otherwise, errors are captured in responses.

Examples

Example 1: Basic approval request with markdown content

Set operation to Approve, provide one device ID, title 'Update Required', body 'Please review changes', reviewContentType markdown, reviewContentMarkdown 'Is this acceptable?', approvalActions approval label 'Yes' URL 'https://example.com/webhook/approve', refinement label 'No' URL 'https://example.com/webhook/refine'.

Example 2: Approval request with block list content

Set operation to Approve, provide device IDs, title and body, reviewContentType list, add blocks (e.g., text, image, workflowTrigger), configure approvalActions as above.

Links

Discussion