Cron Trigger

Type ID: cronTrigger  ·  Kind: Trigger  ·  Trigger style: poll  ·  Trace: CHAIN

A root trigger that emits a single metadata item on a schedule. The TriggerOrchestrator activates it with a cron schedule (or fixed interval) and calls poll() on each tick.

Credentials

None

Properties

Property	Key	Type	Required	Default	Possible values	Shown when
Schedule	schedule	object	Yes	—	Schedule configuration (see nested fields below)	Always

Schedule (nested fields)

Property	Key	Type	Required	Default	Possible values	Shown when
Cron Expression	cronExpression	string	No	''	Cron pattern. Overrides the poll interval when set.	Always
Poll Interval	pollIntervalMs	number	No	60000	Interval in milliseconds at which the workflow triggers.	Always

Notes

Fires via the poll() method, which reads the schedule from triggerParams.schedule (falling back to the trigger params themselves). When cronExpression is set it takes precedence over pollIntervalMs. Each tick emits one item with __kind: 'json' containing:

• triggeredAt — ISO timestamp of the tick
• workflowId — the current workflow ID
• cronExpression — included only when a cron expression is configured
• interval — the pollIntervalMs value, included only when no cron expression is set

The node always emits exactly one item per tick (it never returns null).