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

# Email

> Email is the channel Inbox uses today. Provision sending addresses, bring a custom domain, and send from Yorlet.

Email is how most [Inbox](/business-automation/inbox/overview) threads start today. Provision an address, optionally on a domain you already own, then send from the Dashboard, the API, or an [agent](/business-automation/inbox/agents). Replies land on the same thread in Inbox.

Manage addresses from [Settings → Emails](https://dashboard.yorlet.com/settings/emails). Open conversations from the [Inbox](https://dashboard.yorlet.com/inbox).

## Provision an address

You can provision more than one address. The first one on the account is marked as the agent address. Names such as `support`, `noreply`, and `admin` are reserved.

To provision an address, follow these steps:

1. Go to [Settings → Emails](https://dashboard.yorlet.com/settings/emails).
2. Under **New address**, enter a **Local part** — for example `vita` for [vita@yorlet.email](mailto:vita@yorlet.email).
3. Choose a **Domain**. **Yorlet-managed** uses yorlet.email in production, and sandbox.yorlet.email in the [sandbox](/api/environments). A verified custom domain appears in the list once it is live.
4. Optionally enter a **Display name** for the From header.
5. Choose **Matching** — **Customers first** or **Owners first**. When an inbound sender matches both a customer and an owner, Yorlet uses this type. Defaults to customers.
6. Wait for availability to confirm the address is free, then click **Provision**.

Delete an address from its row if you no longer need it. If you delete the agent address, pick another one in [Settings → Agents](https://dashboard.yorlet.com/settings/agents).

<Tip>
  Set which address agents send from in [Settings → Agents](https://dashboard.yorlet.com/settings/agents), under **Agent email**. See [Agents](/business-automation/inbox/agents).
</Tip>

## Custom domains

Bring your own domain if you want customers to see mail from an address you already own. Add a subdomain such as `mail.acme.com` so Yorlet’s receiving records do not clash with your existing mailbox.

To add a custom domain, follow these steps:

1. Go to [Settings → Emails](https://dashboard.yorlet.com/settings/emails).
2. Under **Add domain**, enter the domain and click **Add**.
3. Copy the **Type**, **Name**, and **Value** records to your DNS provider.
4. Click **Verify**. The status badge moves from **pending** to **verified** once the records check out, or to **failed** if they do not.

You can click **Verify** again after you have fixed DNS. Delete a domain if you no longer want it on the account.

Once a domain is **verified**, it appears in the address **Domain** list.

<Warning>
  Deleting a custom domain stops Yorlet from sending and receiving on it. Addresses that still use that domain will not be able to send until you provision them on another verified domain.
</Warning>

## Send on a thread

Anyone with the **Send email** permission can send from a provisioned address. That includes Dashboard users and [API keys](/development/api-keys). Agent sends — from the assistant, the email agent, Recover triage, or [Claude or ChatGPT](/business-automation/ai/mcp) — still follow [agent policy](/business-automation/ai/policy) and wait in [Approvals](/business-automation/ai/approvals) by default.

You can send to a customer, an owner, or a raw email address, optionally on an existing [thread](/business-automation/inbox/overview). The send is stored as an outbound message on that thread’s timeline in Inbox.

To send from the Dashboard, click **New conversation** on [Inbox](https://dashboard.yorlet.com/inbox), or on a customer or owner page. See [Inbox](/business-automation/inbox/overview).

## Test inbound mail

In the [sandbox](/api/environments), you can simulate an inbound email without sending a real message. This creates a received message on a thread, the same way a customer or owner emailing a provisioned address would.

To simulate inbound mail, follow these steps:

1. Go to [Inbox](https://dashboard.yorlet.com/inbox).
2. Click **Simulate inbound**.
3. Choose who the mail is from — a customer, an owner, or a raw email address — and which provisioned address it is to. Leave **To** as the agent address if you want the [email agent](/business-automation/inbox/agents) to draft a reply.
4. Enter a **Subject** and **Body**, then click **Simulate**.

You can also simulate a reply from an open thread. The new message is added to that conversation.