> For the complete documentation index, see [llms.txt](https://developer.kizen.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developer.kizen.com/docs/concepts/agentic-workflows/agentic-workflow-triggers/action-based-triggers.md).

# Action-Based Triggers

Learn how action-based triggers work in Kizen, including field updates, stage changes, form submissions, tag events, and when each trigger fires on a Record.

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

**Purpose:** Documents each action-based trigger type in <code class="expression">space.vars.Kizen\_company\_name</code>: what it does, when it fires, and the behavioral details that affect how <code class="expression">space.vars.automations</code> respond to <code class="expression">space.vars.entity</code> changes and user actions.
{% endhint %}

## Overview

Action-based triggers fire in response to a data change or user action on a <code class="expression">space.vars.entity</code>. When the specified event occurs, <code class="expression">space.vars.Kizen\_company\_name</code> queues a trigger evaluation. If the trigger conditions are satisfied it then initiates a new <code class="expression">space.vars.automation</code> execution.

### Activity Logged

This trigger fires when an <code class="expression">space.vars.activity</code> of a selected type is logged on a <code class="expression">space.vars.entity</code>.&#x20;

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2Ft8RFkx4GFU2vx13hW3JS%2FScreenshot%202026-03-31%20at%208.53.30%E2%80%AFAM.png?alt=media&amp;token=5c821a88-ae80-4c28-a9bd-341e355c04ae" alt="" width="252"><figcaption></figcaption></figure></div>

Each trigger configuration listens for a single <code class="expression">space.vars.activity</code> type. To respond to multiple <code class="expression">space.vars.activity</code> types on the same <code class="expression">space.vars.automation</code>, configure a separate trigger for each.

{% hint style="info" %}
**Note**: Scheduling a future <code class="expression">space.vars.activity</code> task does not fire this trigger. It evaluates only at the moment an <code class="expression">space.vars.activity</code> is marked as completed and logged.
{% endhint %}

### New Record Created

Fires when a new <code class="expression">space.vars.entity</code> is created. Can be configured to fire on creation, unarchive, or both.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FYYFyD1JXUHB2dPRLoTak%2FScreenshot%202026-03-31%20at%209.09.43%E2%80%AFAM.png?alt=media&amp;token=ed8ad01d-dbf7-4d47-85ab-0cc4469db858" alt="" width="255"><figcaption></figcaption></figure></div>

Field values available at trigger time reflect only what was present at the moment of creation. Values populated by subsequent actions or <code class="expression">space.vars.automations</code> will not be available.

### Field Updated

Fires when a specified field's value changes on a <code class="expression">space.vars.entity</code>.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FUFAXVkjhmcoJQa0R8QWe%2FScreenshot%202026-03-31%20at%209.31.34%E2%80%AFAM.png?alt=media&amp;token=b74c895f-eff4-4d43-be80-ff5a22cbe10e" alt="" width="257"><figcaption></figcaption></figure></div>

By default, the trigger fires on any change to the field. You can narrow this by configuring from and to values. For example, only when a Status field transitions from *Prospect* to *Qualified*. Transitions to or from a blank value are supported and can be explicitly targeted.

An optional trigger on create setting causes the trigger to evaluate at <code class="expression">space.vars.entity</code> creation. If no from/to values are configured, enabling this option will cause the trigger to fire on every new <code class="expression">space.vars.entity</code> regardless of the field's initial value.

### Stage Updated

Fires when a <code class="expression">space.vars.entity</code> moves from one workflow stage to another.&#x20;

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2Fgok8NkrIC8iUQNKS9VpA%2FScreenshot%202026-03-31%20at%209.34.10%E2%80%AFAM.png?alt=media&amp;token=bbb3882a-7886-4223-8fd3-820a07594d20" alt="" width="254"><figcaption></figcaption></figure></div>

This trigger is only available on <code class="expression">space.vars.object</code> <code class="expression">space.vars.automations</code>; it is not available in <code class="expression">space.vars.contact</code>, Global, or standard <code class="expression">space.vars.object</code> <code class="expression">space.vars.automation</code> contexts.

### Form Submitted

Fires when a specific form associated with the <code class="expression">space.vars.entity</code> is submitted.&#x20;

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FlDI5wf7CFTClAKfJ16XU%2FScreenshot%202026-03-31%20at%209.39.42%E2%80%AFAM.png?alt=media&amp;token=83895c63-2f1d-4116-844a-95adb117f2cb" alt="" width="252"><figcaption></figcaption></figure></div>

Scoped to a single form per trigger configuration. It does not fire for all form submissions on the <code class="expression">space.vars.entity</code>.

### Survey Submitted

Fires when a specific survey associated with the <code class="expression">space.vars.entity</code> is submitted.

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2Fj6rQCqIN6tCPW83MKX2D%2FScreenshot%202026-03-31%20at%209.42.10%E2%80%AFAM.png?alt=media&amp;token=1e011df7-73ed-4f2f-a230-cee7634756e5" alt="" width="254"><figcaption></figcaption></figure></div>

Behaves consistently with Form Submitted, and is scoped to a single survey per trigger configuration.

### Email Received

Fires when an email is received from a <code class="expression">space.vars.contact</code>.&#x20;

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FQMiNsG5u6C8MrExFEnvk%2FScreenshot%202026-03-31%20at%209.48.14%E2%80%AFAM.png?alt=media&amp;token=6bfd3e16-80da-4034-a7a3-520b24efe226" alt="" width="251"><figcaption></figcaption></figure></div>

This trigger is only available on <code class="expression">space.vars.contact</code> <code class="expression">space.vars.automations</code>. It is not available in <code class="expression">space.vars.workflow</code>, Global, or standard <code class="expression">space.vars.object</code> <code class="expression">space.vars.automation</code> contexts.

### Tag Added / Tag Removed

Fires when a specific tag is added to or removed from a <code class="expression">space.vars.entity</code>.&#x20;

<div data-with-frame="true"><figure><img src="https://3898351136-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FQd8ufpN7wkdnx7JtgoeZ%2Fuploads%2FEpt3PxhGxI1LyD0cb6Ez%2FScreenshot%202026-03-31%20at%209.48.03%E2%80%AFAM.png?alt=media&amp;token=9fda8f29-85ab-405a-bdaf-f7d9cda27099" alt="" width="255"><figcaption></figcaption></figure></div>

Tag Added and Tag Removed are separate trigger types. To respond to both directions of a tag change on the same <code class="expression">space.vars.automation</code>, configure one trigger of each type.

***

## What's Next?

Continue to [Scheduled Triggers](/docs/concepts/agentic-workflows/agentic-workflow-triggers/scheduled-triggers.md) to understand the trigger types that fire based on time or date field values.

<details>

<summary>Related Topics</summary>

* [Agentic Workflow Triggers](/docs/concepts/agentic-workflows/agentic-workflow-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)
* [Agentic Workflow Code Step](/docs/concepts/agentic-workflows/automation-code-steps.md)

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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, and the optional `goal` query parameter:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.