# Triggered Emails

### Creating a Triggered Email

To set up a triggered email, go to the Form Dashboard and click **Manage Triggered Emails**, then click **Create Triggered Email.**

<figure><img src="/files/mT3pkmcm66rejGvudtpN" alt="A screenshot of the Triggered Emails view for a form, showing the Create Triggered Email button and an empty list."><figcaption><p>The Triggered Emails screen for a form, showing the Create Triggered Email button and an empty list.</p></figcaption></figure>

When creating a triggered email, you have two optional starting points:

* **I want to start by copying an existing Triggered Email** — copies the content and settings from an existing triggered email, saving you from starting from scratch if you have a similar one already set up.
* **I want to start by loading in content from an Email Template** — loads in the content from an existing email template as the starting point for your triggered email.

Give your triggered email a **Name** and an optional **Description**, then click **OK** to continue.

<figure><img src="/files/4KjGiu2IpRfJ7QXMc6rT" alt="A screenshot of the Create Triggered Email dialog showing the two optional starting points and fields for name and description."><figcaption><p>The Create Triggered Email dialog showing the two optional starting points and fields for name and description.</p></figcaption></figure>

***

### Content & Preview

After creating your triggered email, you will be taken to the Triggered Email Dashboard. Go to **Triggered Email Content** to set up your header fields — including To Email, To Name, From Email, From Name, Reply Email, Reply Name, Subject, and Pre-Header Text. Merge fields can be used in any of these fields.

Merge fields let you pull in values from the form submission. For Update Forms, you can also merge in database fields.

You will also need to build the body content of your email using the standard email content editor, the same one used in Mailouts and Automated Mailouts.

Attachments can be added to triggered emails, though it is generally better to host files in the UbiQuity Media Manager and link to them rather than attaching directly.

To preview your triggered email, click **Preview** to send a test to your inbox. For Update Forms, select a database contact from the Preview screen to see how database merge fields will appear.

Note that to fully test form field merging, you will need to actually submit the form and receive the triggered email.

***

### Conditions

Use **Edit Conditions** to control when a triggered email is sent. If no conditions are set, the email sends every time the form is submitted. For Update Forms, conditions can reference both form fields and database fields, including previous events for the contact.

<figure><img src="/files/zscCoc52RDnVbCwpdX2U" alt="A screenshot of the Conditions view where you can add conditions to control when the triggered email is sent."><figcaption><p>The Conditions screen where you can add conditions to control when the triggered email is sent.</p></figcaption></figure>

***

### Activating

When your triggered email is ready, activate it from the Triggered Email Dashboard by clicking **Activate Triggered Email**, and typing ACCEPT to confirm activation.

<figure><img src="/files/GU9FsqvUpAocCwycQhme" alt="A screenshot of the Triggered Email Dashboard showing the Activate button in the top left corner."><figcaption><p>The Triggered Email Dashboard showing the Activate button in the top left corner.</p></figcaption></figure>


---

# 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://docs.ubiquity.co.nz/documentation/data-capture/forms/triggered-emails.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.