> For the complete documentation index, see [llms.txt](https://docs.planetcrust.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.planetcrust.com/human-automations/building-taq-automations/taq-triggers.md).

# TAQ Triggers

<p align="center"><a href="https://buy.polar.sh/polar_cl_MKycmV54KogEiCMy7Oqf4zXIwWZ7wOPhtf5xg3dTn21" class="button primary" data-icon="square-caret-right">Try @Human</a><a href="https://buy.polar.sh/polar_cl_MKycmV54KogEiCMy7Oqf4zXIwWZ7wOPhtf5xg3dTn21" class="button primary" data-icon="check">Buy @Human Subscription</a><a href="https://www.planetcrust.com/human-community" class="button primary" data-icon="comments">Join @Human Community</a></p>

### Creating Triggers

The first block on any TAQ Canvas will be the "Add Trigger" block

<figure><img src="/files/w9BB3VOpsLQvE9KrPHy1" alt=""><figcaption></figcaption></figure>

Clicking on "Add Trigger" will open a modal from which you can select a Trigger type

<figure><img src="/files/rekMrbOagdgc8enrvQY7" alt=""><figcaption></figcaption></figure>

### Trigger Types

There are 4 key types of TAQ Triggers. They are mostly self-explanatory.

* System Triggers include Manual (i.e. button on a Namespace application), Interval (e.g. every 24 hours) and Timestamp (e.g. DD-MM-YYYY)
* Record Triggers involve triggering a TAQ before and after Namespace application records are created, updated or deleted (e.g. after a lead is created in the @Human CRM, the user will receive a notification)
* User Triggers involve triggering a TAQ after users are created, updated, suspended or deleted (e.g. when a user is created, send them a welcome notification)
* Agent Invoke Triggers are used when a TAQ needs to receive the output of an Agent as its triggering input. The Agent Invoke Trigger enables safe handover between the Agent and the TAQ.&#x20;
* Connection Triggers refer to trigger events from third party connections (e.g. when a new branch is created in Github, update the engineering events record).&#x20;

### System Triggers

#### Manual Trigger

The Manual Trigger is the simplest to configure in the TAQ itself.

<figure><img src="/files/Yd6xvhxsJsUav0NcMRHW" alt=""><figcaption></figcaption></figure>

To use a Manual Trigger in a Namespace application, you will need to add an [Automation block](#user-content-fn-1)[^1] in a Page Builder.&#x20;

<figure><img src="/files/M5azLbSLR2NzlkX2CXFJ" alt=""><figcaption></figcaption></figure>

The button can be added to any page and sized or coloured as required

<figure><img src="/files/FJHc71eJsv9rh5JHPDvF" alt=""><figcaption></figcaption></figure>

#### Interval Trigger

As the name suggests, you may choose an interval from the dropdown list. The TAQ will run each time this interval occurs

<figure><img src="/files/DJCab0C7hkY1J8ue62q2" alt=""><figcaption></figcaption></figure>

#### Timestamp Trigger

Pick a specific date and time at which you require your TAQ to run

<figure><img src="/files/5zf3a8XJRXSTiNyebAOF" alt=""><figcaption></figcaption></figure>

### Record Triggers

#### After Record Create

This Trigger is one of the most popular. You  need to enter both the Namespace application and the specific Module in which the Record will be created. The TAQ will start each time a record is created in this module (e.g. a new lead has been created in the Lead Module of the CRM Namespace, then prompt an agent to write a welcome email and send it the following morning at 9am)

<figure><img src="/files/l4YBaL1yS5LfM9gy3vKA" alt=""><figcaption></figcaption></figure>

#### After Record Delete

You  need to enter both the Namespace application and the specific Module in which the Record will be created. The TAQ will start each time a record is created in this module.

<figure><img src="/files/TYyQkOUidC8PCLkChadx" alt=""><figcaption></figcaption></figure>

#### After Record Undelete

Records at the Namespace application layer are only "soft" deleted in @Human (Hard delete is done at the database layer). This can be a useful feature e.g. if records need to be recovered in order to continue process.

<figure><img src="/files/FCwqF5DE5r88xbIeSoVT" alt=""><figcaption></figcaption></figure>

#### After Record Update

Changes to records can often be used to trigger process e.g. a change in an employee's status might imply the need to have new system roles.

<figure><img src="/files/0vYNYd49xvo0bCD2gjXA" alt=""><figcaption></figcaption></figure>

#### Before Record Create

This is a particularly useful Trigger for cross-checks e.g. verifying that an account does not already exist before you create a new one.

<figure><img src="/files/e7v1Rt6QChcGCISWo2ow" alt=""><figcaption></figcaption></figure>

#### Before Record Delete

This Trigger is useful for cross-checks before removing a record e.g. are there any related outstanding actions, such as support requests, required for an account before the record is deleted.

<figure><img src="/files/VlKCrGyEArnVKzfwYt9z" alt=""><figcaption></figcaption></figure>

#### Before Record Undelete

Can be useful in scenarios where undeletion is subject to a policy check or in scenarios where duplication checking might be necessary.&#x20;

<figure><img src="/files/2g2MCLf8swN2OkRo5F9D" alt=""><figcaption></figcaption></figure>

#### Before Record Update

Excellent for checking whether changes have already been applied or for creating conditional logic based on an existing record state.

<figure><img src="/files/OCDGT9gjbXtrhQ66xARl" alt=""><figcaption></figcaption></figure>

### Agent Invoked Trigger

The Agent Invoked Trigger is specifically for use when an @Human Agent needs to invoke a TAQ and pass a value to it.&#x20;

The type of value expected is usually a text string, but it can also be a number or a boolean/checkbox (e.g. when the Agent needs to confirm a decision).

<figure><img src="/files/Yhnf4AZbgxWCBQxdkPnU" alt=""><figcaption></figcaption></figure>

The TAQ to be used by the Agent is selected within the Agent Configuration interface.&#x20;

<figure><img src="/files/kaAut5Y2c8c6brCRrJxD" alt=""><figcaption></figcaption></figure>

[^1]: Add link


---

# 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:

```
GET https://docs.planetcrust.com/human-automations/building-taq-automations/taq-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.
