Skip to main content

6. trigger_action_flow — Trigger Action Flows

Mode: Custom only · Category: Other

Connects the Process Copilot to an Action Flow. Each instance requires a unique_id. The Process Copilot creator fully defines which action flow to call and what inputs it expects.

Minimal — no inputs

- id: trigger_action_flow
  unique_id: run_cleanup
  flow_key: my-package.cleanup-scenario
  flow_display_name: Run Data Cleanup

With input schema — LLM fills the inputs

- id: trigger_action_flow
  unique_id: send_email
  description: Sends an email to a recipient given an email address and body.
  flow_key: my-package.email-scenario
  flow_display_name: Send Email Flow
  disable_confirm: false
  flow_input_schema:
    type: object
    required:
      - email
      - body
    properties:
      email:
        type: string
        description: Email address to send to.
        display_name: Email Address
      body:
        type: string
        description: The body of the email.
        display_name: Email Body

Multiple action flows in one Process Copilot

- id: trigger_action_flow
  unique_id: send_email
  flow_key: my-package.email-scenario
  flow_display_name: Send Email
  flow_input_schema:
    type: object
    required: [email, body]
    properties:
      email:
        type: string
        description: Recipient email address.
      body:
        type: string
        description: Email body text.

- id: trigger_action_flow
  unique_id: create_ticket
  flow_key: my-package.ticket-scenario
  flow_display_name: Create Support Ticket
  disable_confirm: true
  flow_input_schema:
    type: object
    required: [title, priority]
    properties:
      title:
        type: string
        description: Ticket title.
      priority:
        type: string
        description: Priority level (low, medium, high).

Config fields

pc_at_trigger_af.png

Field

Type

Description

unique_id

string

Required — unique identifier for this action flow instance.

flow_display_name

string

Required — name shown to the user in the confirmation card.

flow_key

string

Action flow key (package.scenario format).

flow_input_schema

object

JSON Schema defining inputs. Each property becomes an LLM argument.

disable_confirm

bool

Skip user confirmation before execution (default: requires confirmation).

flow_node_id

string

Deprecated — legacy webhook node ID.

flow_hook_id

string

Deprecated — legacy webhook hook ID.

Related topics