> ## Documentation Index
> Fetch the complete documentation index at: https://useidalia.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Automations

> Create an automation, add a trigger, and turn it on.

## Overview

An automation runs an agent when a trigger fires. It stores the instructions for that run, and the tools the agent can use.

A new automation is **Inactive**. It does not run until you save a trigger and instructions, then set it to **Active**.

You choose the agent that runs. The default agent is **Idalia**. You can choose a [custom agent](https://useidalia.com/docs/workflows/custom-agents.md) instead.

The **reviewer** checks suggestions from the automation. When the reviewer is empty, Idalia uses the person who created the [form](https://useidalia.com/docs/workflows/forms.md).

## View automations

You can view and manage automations from the [Automations](https://idalia.app/automations) page. Search the list, switch between **All**, **Enabled**, and **Disabled**, and open an automation.

Open an automation to see **Settings** and **Runs**. Settings is where you edit the automation. Runs is the history of each time it fired.

## Ask the agent

Open the chat. See [Using AI](https://useidalia.com/docs/guides/using-ai). Tell the agent what starts the automation and what it must do.

Example: "When the Site diary form is submitted, create a transport order from the answers."

The agent writes the instructions and saves the automation. The automation stays **Inactive** until you ask the agent to turn it on, or you set it to **Active** on the automation page.

## Create an automation

On the Automations page, press <kbd>Create</kbd> (shortcut <kbd>C</kbd>).

Idalia opens a new automation named **Untitled**. It is inactive, and it has no trigger and no instructions.

Change the name on the automation page. A name is required when you save.

> [!NOTE]
>
> If your role cannot create automations, the Create button is hidden.

## Add a trigger

A trigger is the event that starts a run. An automation needs at least one trigger before you can turn it on.

On **Settings**, press <kbd>Add trigger</kbd>.

**When something happens**

* **Form submitted** — choose the form. The automation runs when someone submits that form. You can add more than one form. The same form cannot be added twice.
* **Email received** — the automation runs when someone on your team sends email to your workspace address from their Idalia account. The address is your workspace slug plus `@ai.idalia.app`. An automation can have one email trigger. Press <kbd>Add trigger</kbd> in the dialog to keep it.

**On a schedule**

Open **Every…** and choose **Hour**, **Day**, or **Week**.

* **Every hour** runs at the start of each hour.
* **Every day** runs once a day at midnight.
* **Every week** runs once a week on Sunday at midnight.

These times use UTC.

Hover a trigger and press the remove control to take it off the automation. Save to keep the change.

## Write the instructions

On **Settings**, write **Instructions**. Say what should happen when the automation runs. Instructions are required.

Press <kbd>Save</kbd> (shortcut <kbd>⌘</kbd> + <kbd>Enter</kbd>). The trigger and the instructions are not active until you save them.

## Choose the agent and tools

On **Settings**, set these before you save:

* **Agent** — **Idalia**, or a custom agent that is active.
* **Reviewer** — **Form creator**, or a person in the workspace.
* **Tools** — press <kbd>Add Tool</kbd> and choose **Send Email** when the agent may email people. **Send Email** sends one message to the people you select. Add at least one recipient. The automation cannot turn on while Send Email has no recipients.

## Turn an automation on

Save first. Then set the switch to **Active**.

Idalia blocks the switch when the saved automation has no instructions or no trigger. The dialog lists what is missing. If you added them and did not save, the dialog says **Save required**.

Set the switch to **Inactive** to stop new runs. Past runs stay on **Runs**.

## Read a run

Open **Runs** on the automation. Each row is one run. The status is **Pending**, **In Progress**, **Completed**, or **Failed**.

Open a run to read what the agent did. The list says **No runs yet** until the first trigger fires.

## Update an automation

Open the automation and change the name, triggers, instructions, agent, reviewer, or tools on **Settings**. Press <kbd>Save</kbd>.

If the automation is active, save the change before you expect the next run to use it.

## Delete an automation

Delete is permanent. Use it when the automation should leave the workspace.

1. Open the automation.
2. Open the **⋯** menu.
3. Choose **Delete**.
4. Confirm in the dialog.

Idalia takes you back to the Automations list.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.