Trigger Flow
Follow the flow-automation skill (${CLAUDE_PLUGIN_ROOT}/skills/flow-automation/SKILL.md) for how flows, triggers and operations work; read it before the first call.
Arguments
flow-name-or-id(required) — Flow name (partial match) or UUIDcollection(required) — Collection context--keys <id1,id2>— Item IDs (required if flow needs selection)--data <json>— JSON payload passed as$trigger.body
Process
Find the flow:
- Call
flowstool withaction: "read"to list all flows - Match by name (partial, case-insensitive) or by UUID
- If multiple matches, ask user to clarify
- Call
Read flow definition:
- Call
flowstool withaction: "read"andkey: "<flow-uuid>" - Check trigger type (must be manual or webhook for programmatic triggering)
- Check if
requireSelectionis set (if yes,--keysis required) - Show flow details to user before triggering
- Call
Trigger the flow:
{ "id": "<flow-uuid>", "collection": "<collection>", "keys": ["<id1>", "<id2>"], "data": { "custom": "payload" } }Display the flow execution result
Example
Input: "Welcome Email" contacts --keys abc-123 --data {"send_now": true}
Important
- Always read the flow definition before triggering
- Verify the flow is active (status: "active")
- Check trigger type compatibility
- Warn user before triggering flows with side effects (emails, webhooks, deletions)