Unify Logo Footer.svg
Unify Automations
Logo
On Event Trigger

On Event Trigger

Logo

2 mins READ

On Event Trigger starts an automation the moment a new event is published to a stream. There is no polling interval — the automation fires in real time as soon as the event arrives. A variant, On Event (Polling), checks the stream on a schedule and processes waiting events in batches. Use the real-time mode for immediate reactions; use polling mode when scheduled batch processing is preferred.

Overview

The On Event Trigger is the trigger entry point for event-driven automations. Configuring it tells the platform to watch a named stream on behalf of a consumer group and dispatch a new run for every event it detects. The polling variant fires on a schedule instead of reacting instantly, which gives more control over when processing happens and how load is spread. Both modes use a consumer group to track the stream offset, so events are not missed between runs.

stream-trigger-1 1.png
stream-trigger-1 1.png

Input

Field

Type

Required

Description

Stream

String

Yes

Name of the stream to listen on.

Consumer group

String

Yes

Consumer group that tracks the position. Each group receives every event independently from other groups.

Trigger mode

Enum

Yes

Real-time — fires instantly per event; Polling — checks the stream on a defined schedule.

Polling interval

String

Conditional

Schedule expression (cron or interval) controlling how often to check for new events. Required when Trigger mode is Polling.

Starting position

Enum

Yes

Where a brand-new consumer group begins: Earliest (from the start of the stream) or Latest (only events published after the group is created).

Enable DLQ tracking

Boolean

No

When enabled, holds failed events so they can be routed to the dead-letter queue via the Update DLQ action. Default: off.

stream-trigger-2 1.png
stream-trigger-2 1.png

Output

Each run receives the event or events that triggered it.

Field

Type

Description

event

Object

The event that triggered this run: ID, key, payload, and timestamp. In polling mode, this may be an array of events accumulated since the last check.

offset

Number

Stream offset of the triggering event.

Notes

  • Real-time mode fires once per published event — one automation run per event.

  • Polling mode fires once per check interval, processing any events that have accumulated since the last run.

  • Both modes use a consumer group to track position; events are not missed between runs even if the automation is temporarily paused.

  • Starting position only applies to brand-new consumer groups. An established group always resumes from its last committed offset.

  • Enable DLQ tracking if you plan to route failed events to the dead-letter queue using the Update DLQ action later in the automation.

FAQs

What is the difference between On Event and On Event (Polling)?

On Event fires the moment an event is published — latency is near zero, and one run is dispatched per event. On Event (Polling) checks the stream on a defined schedule and processes any events that have accumulated; useful when you prefer batch-style processing or need to spread load across time.

Can multiple automations react to the same event?

Yes. Use different consumer groups for each automation. Each group tracks its own offset and receives every event independently, so the same event triggers all groups that are listening.

What happens to events published while the automation is paused or disabled?

They accumulate in the stream at the current offset. When the automation is re-enabled, the consumer group resumes from its last committed position and processes the missed events in order.