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

# Email

> A one-time code sent to the email address in your directory. Settings, delivery, mail gateway allowlisting and troubleshooting.

Email sends a one-time code to the address on file. It proves the employee can read the mailbox your directory says is theirs. It works well for office staff with their own corporate inbox, and less well for people without corporate email or with shared mailboxes.

## Before you start

* A connected directory with email addresses.
* Your mail gateway allows mail from TruU's sender domain. If your gateway filters external senders, ask [support](https://docs.truu.ai/idv/resources/support.md) for the domain to allowlist.
* Nothing else. TruU sends email through its own provider; there's no SMTP relay or DNS change.

## Settings

Open **Factors → Email**.

| Setting | What it does | Default |
| - | - | - |
| **Email attributes** | Directory attributes tried in order; the first with a value for the employee is used. Add a fallback if some employees don't have a corporate mailbox. | `mail` |
| **Attempts per run** | Wrong codes allowed before the factor fails | 2 tries |
| **Code length** | 4, 6 or 8 digits | 6 digits |
| **Code expiry** | 2, 5 or 10 minutes | 5 minutes |

## What the employee sees

A code arrives by email with your workspace's branding. The employee enters it on the verification page and can request a new code after a 30-second countdown, up to 3 times. When sending a link, help desk agents see the address on file and can change it.

## Troubleshooting

| Symptom | Cause | Fix |
| - | - | - |
| The code takes minutes to arrive | The mail gateway scans links before delivery | Resend works. If it's routine, allowlist TruU's sender domain. |
| The email never arrives | Quarantine, or `mail` holds an alias that no longer delivers | Check the gateway quarantine, then the value in the directory |
| A shared mailbox gets the code | A role or shared mailbox is stored in `mail` | Store the employee's own address; shared mailboxes don't prove anything about one person |

## Related

* [SMS](https://docs.truu.ai/idv/factors/sms.md)
* [How factors work](https://docs.truu.ai/idv/factors/overview.md)


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