{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":["img"]},"type":"markdown"},"seo":{"title":"Trigger Action Flow - trigger_action_flow","description":"API documentation for Celonis APIs.","siteUrl":"https://developer.celonis.com/","keywords":"celonis developer portal, celonis apis, celonis api reference docs","lang":"en-US","llmstxt":{"hide":false,"description":"Celonis API documentation","sections":[{"title":"API Docs","description":"Available Celonis API Docs","includeFiles":["**/*.md"]},{"title":"API Specs","description":"All Celonis API specifications","includeFiles":["**/openapi.yaml"]}]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"trigger-action-flow---trigger_action_flow","__idx":0},"children":["Trigger Action Flow - trigger_action_flow"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Mode"]},": Custom only · ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Category"]},": Other"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Connects the asset to an Action Flow. Each instance requires a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unique_id"]},". The asset creator defines which Action Flow to call and what inputs it expects."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"minimal--no-inputs","__idx":1},"children":["Minimal — no inputs"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: trigger_action_flow  \n  unique_id: run_cleanup  \n  flow_key: my-package.cleanup-scenario  \n  flow_display_name: Run Data Cleanup\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"with-input-schema--llm-fills-the-inputs","__idx":2},"children":["With input schema — LLM fills the inputs"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: trigger_action_flow  \n  unique_id: send_email  \n  description: Sends an email to a recipient given an email address and body.  \n  flow_key: my-package.email-scenario  \n  flow_display_name: Send Email Flow  \n  disable_confirm: false  \n  flow_input_schema:  \n    type: object  \n    required:  \n      - email  \n      - body  \n    properties:  \n      email:  \n        type: string  \n        description: Email address to send to.  \n        display_name: Email Address  \n      body:  \n        type: string  \n        description: The body of the email.  \n        display_name: Email Body\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"multiple-action-flows-in-one-process-copilot","__idx":3},"children":["Multiple Action Flows in one Process Copilot"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"header":{"controls":{"copy":{}}},"source":"- id: trigger_action_flow  \n  unique_id: send_email  \n  flow_key: my-package.email-scenario  \n  flow_display_name: Send Email  \n  flow_input_schema:  \n    type: object  \n    required: [email, body]  \n    properties:  \n      email:  \n        type: string  \n        description: Recipient email address.  \n      body:  \n        type: string  \n        description: Email body text.\n\n- id: trigger_action_flow  \n  unique_id: create_ticket  \n  flow_key: my-package.ticket-scenario  \n  flow_display_name: Create Support Ticket  \n  disable_confirm: true  \n  flow_input_schema:  \n    type: object  \n    required: [title, priority]  \n    properties:  \n      title:  \n        type: string  \n        description: Ticket title.  \n      priority:  \n        type: string  \n        description: Priority level (low, medium, high).\n"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"config-fields","__idx":4},"children":["Config fields"]},{"$$mdtype":"Tag","name":"Image","attributes":{"src":"/assets/mcp-tools-add-trigger-af.929ab9b315771604fad04c380ea2577116db69a378820a12a5bf7b0466b02af6.a6bd5218.png","alt":"mcp-tools-add-trigger-af.png","framed":false,"withLightbox":true,"width":"","height":""},"children":[]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Field"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Field"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Type"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Type"]}]},{"$$mdtype":"Tag","name":"th","attributes":{"align":"left","data-label":"Description"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]}]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["unique_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required"]}," — Unique identifier for this Action Flow instance."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_display_name"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required"]}," — Name shown to the user in the confirmation card."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_key"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Action Flow key (in ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package.scenario"]}," format)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_input_schema"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["object"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["JSON schema defining inputs. Each property becomes an LLM argument."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["disable_confirm"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["bool"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["Skip user confirmation before execution (default: requires confirmation)."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_node_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deprecated"]}," — Legacy webhook node ID."]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["flow_hook_id"]}]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":["string"]},{"$$mdtype":"Tag","name":"td","attributes":{"align":"left"},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Deprecated"]}," — Legacy webhook hook ID."]}]}]}]}]}]},"headings":[{"value":"Trigger Action Flow - trigger_action_flow","id":"trigger-action-flow---trigger_action_flow","depth":1},{"value":"Minimal — no inputs","id":"minimal--no-inputs","depth":2},{"value":"With input schema — LLM fills the inputs","id":"with-input-schema--llm-fills-the-inputs","depth":2},{"value":"Multiple Action Flows in one Process Copilot","id":"multiple-action-flows-in-one-process-copilot","depth":2},{"value":"Config fields","id":"config-fields","depth":2}],"frontmatter":{"seo":{"title":"Trigger Action Flow - trigger_action_flow"}},"lastModified":"2026-08-26T15:26:18.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/mcp-server-asset/tools/trigger_action_flow","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}