# Agentic Workflow Triggers

{% hint style="success" %}
**Audience:** Administrators, Solution Architects, and Developers

**Purpose:** Documents all supported trigger types in <code class="expression">space.vars.Kizen\_company\_name</code>, explains how each one evaluates and fires, and covers the timing and throttling behaviors that govern when <code class="expression">space.vars.automations</code> are initiated.
{% endhint %}

## Overview

Triggers are the mechanism by which <code class="expression">space.vars.automations</code> listen for and respond to events. When a trigger condition is met, <code class="expression">space.vars.Kizen\_company\_name</code> initiates a new execution of the <code class="expression">space.vars.automation</code> and begins processing its configured steps.

***

## Trigger Foundations

The following ground rules apply to all <code class="expression">space.vars.automations</code>, regardless of trigger type.

* **Every Agentic Workflow includes a manual trigger:** A manual trigger is automatically added to every <code class="expression">space.vars.automation</code> at creation. It provides an always-available on-demand initiation method that allows authorized users to start the <code class="expression">space.vars.automation</code> against a <code class="expression">space.vars.entity</code> at any time. The manual trigger coexists alongside any other configured triggers and does not need to be added separately.
* **Available trigger types depend on Agentic Workflow context:** The set of supported triggers differs across Contact <code class="expression">space.vars.automations</code>, Workflow <code class="expression">space.vars.automations</code>, Global <code class="expression">space.vars.automations</code>, and <code class="expression">space.vars.object</code> <code class="expression">space.vars.automations</code>. Not every trigger type is available in every context. Context-specific triggers are called out explicitly in each section below.
* **There is no indicator for duplicate triggers:** <code class="expression">space.vars.Kizen\_company\_name</code> does not display a warning if the same trigger type is configured more than once on an <code class="expression">space.vars.automation</code>. Duplicate triggers can cause a <code class="expression">space.vars.entity</code> to enter the <code class="expression">space.vars.automation</code> multiple times from a single event. You are responsible for identifying and removing duplicate trigger configurations.
* **Trigger order is not guaranteed:** When multiple triggers are configured on an <code class="expression">space.vars.automation</code>, the order in which they fire relative to one another is not guaranteed. <code class="expression">space.vars.automation</code> logic that depends on one trigger firing before another cannot rely on ordering.

***

## Trigger Types

<code class="expression">space.vars.Kizen\_company\_name</code> <code class="expression">space.vars.automations</code> support three categories of triggers. Each category covers a distinct class of initiation event.

| Trigger                                                                                                                                                   | Category     | Description                                                                                                                                                      | Available On                                                                                                                                                  | Agentic Workflow Scope                                    |
| --------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------ | ---------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------- |
| [Activity Logged](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#activity-logged)            | Action-based | Fires when a specific activity type is logged on a <code class="expression">space.vars.entity</code>.                                                            | <code class="expression">space.vars.objects</code>, <code class="expression">space.vars.workflows</code>, <code class="expression">space.vars.contacts</code> | <code class="expression">space.vars.entity</code>, Global |
| [Activity Past Due](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/scheduled-triggers#activity-past-due)           | Scheduled    | Fires when a scheduled activity's due date passes without the activity being completed.                                                                          | <code class="expression">space.vars.objects</code>, <code class="expression">space.vars.workflows</code>, <code class="expression">space.vars.contacts</code> | <code class="expression">space.vars.entity</code>, Global |
| [New Record Created](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#new-record-created)      | Action-based | Fires when a new <code class="expression">space.vars.entity</code> is created for the associated <code class="expression">space.vars.object</code>.              | <code class="expression">space.vars.objects</code>, <code class="expression">space.vars.workflows</code>, <code class="expression">space.vars.contacts</code> | <code class="expression">space.vars.entity</code>         |
| [Field Updated](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#field-updated)                | Action-based | Fires when a specified field's value changes on a <code class="expression">space.vars.entity</code>. Supports from/to value configuration and blank transitions. | <code class="expression">space.vars.objects</code>, <code class="expression">space.vars.workflows</code>, <code class="expression">space.vars.contacts</code> | <code class="expression">space.vars.entity</code>         |
| [On or Around Date](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/scheduled-triggers#on-or-around-date)           | Scheduled    | Fires based on a date field value on a <code class="expression">space.vars.entity</code>, scheduling future executions relative to that date.                    | <code class="expression">space.vars.objects</code>, <code class="expression">space.vars.workflows</code>, <code class="expression">space.vars.contacts</code> | <code class="expression">space.vars.entity</code>         |
| [Stage Updated](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#stage-updated)                | Action-based | Fires when a <code class="expression">space.vars.entity</code> moves from one <code class="expression">space.vars.workflow</code> stage to another.              | <code class="expression">space.vars.workflows</code> only                                                                                                     | <code class="expression">space.vars.entity</code>         |
| [Form Submitted](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#form-submitted)              | Action-based | Fires when a form associated with the <code class="expression">space.vars.entity</code> is submitted.                                                            | <code class="expression">space.vars.entity</code>-based <code class="expression">space.vars.automations</code> only                                           | <code class="expression">space.vars.entity</code>         |
| [Survey Submitted](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#survey-submitted)          | Action-based | Fires when a survey associated with the <code class="expression">space.vars.entity</code> is submitted.                                                          | <code class="expression">space.vars.entity</code>-based <code class="expression">space.vars.automations</code> only                                           | <code class="expression">space.vars.entity</code>         |
| [Webhook Received](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/webhook-triggers)                                | Webhook      | Fires when an inbound HTTP request is received from an external system. Supports JSON payload and URL query parameter extraction.                                | <code class="expression">space.vars.objects</code>, <code class="expression">space.vars.workflows</code>, <code class="expression">space.vars.contacts</code> | <code class="expression">space.vars.entity</code>, Global |
| [Email Received from Contact](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#email-received) | Action-based | Fires when an email is received from a contact.                                                                                                                  | <code class="expression">space.vars.contacts</code> only                                                                                                      | <code class="expression">space.vars.entity</code>         |
| [Tag Added / Removed](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers#tag-added-tag-removed)  | Action-based | Fires when a specific tag is added to or removed from a <code class="expression">space.vars.entity</code>.                                                       | <code class="expression">space.vars.contacts</code> only                                                                                                      | <code class="expression">space.vars.entity</code>         |
| [Scheduled](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/scheduled-triggers#scheduled)                           | Scheduled    | Fires on a user-configured recurring schedule. Runs independently of any specific <code class="expression">space.vars.entity</code>.                             | Global only                                                                                                                                                   | Global                                                    |

## Trigger Timing & Throttling

Understanding when a trigger evaluates and how throttling affects that evaluation is essential for designing <code class="expression">space.vars.automations</code> that behave predictably. These behaviors apply to all trigger types.

#### Asynchronous Queue Evaluation

Triggers do not evaluate synchronously at the moment an event occurs. When a trigger condition is met, the event is queued and evaluated asynchronously. There may be a delay between when an event fires and when the <code class="expression">space.vars.automation</code> begins processing. This delay is normal and expected and is not an indication that a trigger failed or was missed.

#### Trigger Event Time vs. Evaluation Time

Two distinct timestamps are associated with every trigger: the time the event occurred, and the time the trigger was evaluated from the queue. These may differ, particularly under high load or when queue processing is delayed. Both values are recorded and accessible within the <code class="expression">space.vars.automation</code>.

#### Throttling (Quiet Time Window)

Throttling functions as a quiet time or mute window. It is not a mechanism for spacing out or delaying executions.

When throttling is configured on a trigger, additional trigger evaluations for the same record are suppressed within a defined time window after the first trigger fires. Events that occur within that window are discarded and do not queue up to fire later.

* Throttling prevents additional executions from being initiated within the time window.
* It does not delay or redistribute executions.
* Events suppressed by throttling are not recovered after the time window closes.

#### Trigger Timestamp Variable Source

The timestamp of the trigger event is available as a variable source within the <code class="expression">space.vars.automation</code>, captured at the time the execution is created. This value is useful when steps need to reference when the triggering event occurred. For example, logging when a webhook was received or calculating a deadline relative to when a field was updated.

***

## What's Next?

Continue to [Action-Based Triggers ](/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers.md)to understand what happens after an <code class="expression">space.vars.automation</code> is initiated: how executions are created, how steps are processed sequentially and atomically, how the asynchronous model affects data consistency, and how execution state is tracked and managed.

Reviewing the [Agentic Workflow Execution & Processing Model](/docs/concepts/agentic-workflows/agentic-workflow-execution-and-process-model.md) in sequence with this page is recommended if you are designing <code class="expression">space.vars.automations</code> where execution timing, step ordering, or data consistency are important.

<details>

<summary>Related Topics</summary>

* [Starting Agentic Workflows](/docs/concepts/agentic-workflows/starting-agentic-workflows.md)
* [Action-Based Triggers](/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers.md)
* [Scheduled Triggers ](/docs/concepts/agentic-workflows/agentic-workflow-triggers/scheduled-triggers.md)
* [Webhook Triggers](/docs/concepts/agentic-workflows/agentic-workflow-triggers/webhook-triggers.md)

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.