Skip to content

compozy automation triggers create

Create an automation trigger

For people running agent work6 pages in this section

compozy automation triggers create

Create an automation trigger

compozy automation triggers create [flags]

Options

      --agent string                      Agent definition name; choose either --agent or --loop
      --enabled                           Create the trigger enabled or disabled
      --endpoint-slug string              Public endpoint slug for webhook events
      --event string                      Trigger event: session.created, session.stopped, memory.consolidated, hook.<hook_name>.completed, webhook, or ext.*
      --filter stringArray                Exact-match filter(s): key=value or comma-separated key=value pairs
  -h, --help                              help for create
      --loop string                       Loop name; choose either --loop or --agent
      --loop-input stringArray            Static Loop input as key=value; repeat for multiple inputs
      --loop-input-mapping stringArray    Loop input mapping as key=template; repeat for multiple mappings
      --loop-workspace string             Workspace that owns the Loop; required for global automation
      --name string                       Trigger name
      --network string                    Network participation mode: local or live
      --network-bounds string             JSON object for live participation bounds (one object, not flag explosion)
      --network-channel string            Named channel id when strategy is named
      --network-channel-strategy string   Live channel strategy: named, run, or loop_run
      --prompt string                     Agent prompt body; must be empty for Loop targets
      --retry string                      Retry policy: "none", "backoff", or "backoff:<max_retries>:<base_delay>"
      --scope string                      Trigger scope: global or workspace
      --webhook-id string                 Stable webhook identifier override for webhook events
      --webhook-secret-value string       Write-only webhook secret value
      --workspace string                  Override workspace binding (ID, name, or path)

Options inherited from parent commands

      --json            Emit JSON output
  -o, --output string   Output format: human, json, jsonl, or toon (default "human")

Output Formats

The root -o, --output flag accepts these values. A renderer is supported only when this command writes that result; jsonl is for commands that emit one JSON record per line.

FormatCommand result
humanInteractive terminal rendering
jsonMachine-readable JSON rendering
jsonlOne JSON record per line when supported
toonCompact agent-readable rendering

Example:

compozy automation triggers create -o json

On this page