Trigger
An entry point that starts an Automation run — e.g. an incoming
message, a tag applied, a scheduled time, or a webhook/integration event.
type + event select which trigger definition applies; config holds its
type-specific settings.
isActive gates whether the trigger currently fires. New triggers created
by triggersAdd, or produced by cloning
(automationsDuplicate, automationImportFromPAF),
start inactive until explicitly activated.
TriggerFields
Unique trigger document id.
Namespace, unique within the parent automation ({automationNs}:{ns}).
Trigger category (e.g. event, schedule, webhook). See automationCatalog(input: { view: trigger }).
Specific event name within type (e.g. customers.tagged).
Parent Automation _id.
Parent automation's ns.
Node this trigger starts execution at, when different from the automation's default startNodeNs.
Type-specific settings (schedule cron, webhook filters, integration scoping, etc.).
Canvas styling — opaque to execution.
Icon identifier shown on the canvas.
Whether this trigger was hand-authored vs. generated by a template/import.
Canvas { x, y } coordinates. Bulk-update with batchSavePositions.
Reserved for future workflow grouping; not currently populated.
Whether the trigger currently fires. Toggle via triggersEdit.
Integration ids this trigger listens on, for triggers scoped to multiple integrations.
Single integration id this trigger listens on, for single-integration trigger types.
Integration channel kind (e.g. whatsapp, facebook), denormalized for filtering/search.
Execution count for this trigger, when resolved by the caller.
Lightweight parent automation summary — see type TriggerAutomation.