Item Logo
Data intelligenceWorkflowFor developerNodes reference

Triggers

Triggers


Triggers are the entry points that initiate your workflow execution. You must add a Trigger type node as the Start node of a flow. It includes the following types:

  • Schedule Trigger (Cron): Starts at a fixed time or interval using cron expressions.

  • API Trigger: Starts when an external system calls the provided API endpoint.

  • Event Trigger: Starts when a specific system event occurs.

  • Mail Trigger: Starts when incoming emails are received through connected mailboxes.

Cron Trigger

The Cron node is a schedule-based trigger that starts workflows at specified intervals using cron expressions.

migration:di/v3/cron-trigger.png
  • Cron Expression: Time-based scheduling using standard cron syntax. Example: Every 15/30 minutes: 0 /15 ; 0 /30 *`.

  • Dynamic Cron Expressions: Use environment variables for flexible scheduling {{env.import.job_cycle}}.

migration:di/v3/dynamic-vab.png

To Configure the dynamic Cron Expressions:

1. Click the Env environment on the top navig bar. 2. Choose the import variables. 3. Fill in the following fields:

  • Variable Type: Determines data type (String, Array, Number, Boolean, Object).

  • Variable Name: Internal identifier used in expressions.

  • Title: Human-readable display name.

  • Description: Context and usage notes for team members.

  • Default Value: Initial value when the variable is created.

  • Format: Choose from Date Time, Date, Time, or Dict.

  • Dict Key: Specify the dict key.

4. Click OK to save the setting.

API Trigger

Use the API trigger to initiate workflows via HTTP requests. By specifying a path, you can trigger predefined tasks through a constructed URL. This is ideal for event-driven scenarios, such as external systems or services triggering internal processes.

migration:di/v3/api-trigger.png

Settings include:

  • Path: Provide the URL endpoint path

  • Enable rate limiting: Toggle on/off the switch.

  • Rate Limit threshold: Configure request limits per time window.

  • Authentication: Currently support Basic Auth and API Key only. For Basic Auth: Provide Username/password combination; for API Key: Provide Api key only.

Event Trigger

The Event trigger rely on message topics (e.g., Kafka) to initiate workflows when specific events are published to a topic. This provides a dynamic way to handle system changes.

migration:di/v3/event-trigger.png

Settings include:

  • Topic: Event name or category to listen for.

Use Case

Event Topic

Purpose

Order creation

item.oms.order.created

Trigger a fulfillment flow.

Shipment update

item.wms.shipment.completed

Notify customer systems of delivery completion.

  • Example Flow

Mail Trigger

The Mail trigger monitor specific email accounts and initiate workflows based on incoming emails.

migration:di/v3/mail-trigger.png

Settings include:

  • Connector: Choose a mail Connector from the Email provider (Gmail, Outlook, 163 Mail).