---
app: agent
audience:
  - owner
since: 0.1.2
ui_only: true
agent_actions:
  - tool: app_channel_status
    permission: auto
    example: is the sales mailbox connected?
agent_examples:
  - connect a mailbox to the sales agent
  - which emails does the agent read?
llm_weight: normal
title: Email
description: A dedicated mailbox per agent (IMAP/SMTP) — only listed senders are
  read, and never your personal inbox.
editUrl: true
head: []
template: doc
sidebar:
  order: 6
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

import { Steps, Aside } from "@astrojs/starlight/components";
import { AgentAsk, UiOnly } from "@components";

**Who this is for:** an owner who receives orders, supplier invoices or leads by email.

An email account turns incoming mail into work: a supplier's PDF invoice becomes a draft Purchase Invoice, a marketplace order notification a draft Sales Invoice, an inquiry a Lead — depending on which [automations](/agent/automations/catalog/) the agent runs. The agent reads mail through IMAP and replies through SMTP with its own address.

<UiOnly />

## Steps

<Steps>

1. Create a **dedicated mailbox** for the agent (for example `sales-agent@yourdomain.com`, or a fresh Gmail with an **app password**). Never your personal inbox: the agent reads everything the allow-list lets through.

2. Open **Settings → Accounts**, press **+** beside **Email**, pick the agent and fill in: **Email address**, **Email password** (the app password), **IMAP host** (e.g. `imap.gmail.com`), **SMTP host** (e.g. `smtp.gmail.com`) and, if not 587, the **SMTP port**.

3. Fill in **Allowed users** — the sender addresses the agent may read, comma-separated: your suppliers, your marketplace notification address, yourself. Mail from anyone else is ignored.

4. Press **Save**, then **Test connection** at the top of the pane. The badge turns **connected** once the mailbox answers.

</Steps>

<Aside type="caution" title="Email is always allow-listed">
  There is no Public mode for email. Forward mail you want handled from an unlisted sender, or add that sender to the list.
</Aside>

## Ask your agent

<AgentAsk />

## Limits & safety

- One mailbox per agent; the app refuses an address another agent already uses.
- Everything the agent writes into Bakulai from an email is a **draft**; a reply it drafts to a supplier is shown to you first unless the automation says otherwise.

## Troubleshooting

- **Test connection fails with a login error** — Gmail and Outlook need an *app password*, not the account password, and IMAP must be enabled in the mailbox settings.
- **The agent ignores a supplier** — the sender address (or the address behind a display name) is not on the allow-list exactly as written.
- **Replies go out but arrive in spam** — set SPF/DKIM for the domain of the agent's mailbox, as for any business mail.

## Related

[Channels overview](/agent/channels/overview/) · [Automation catalog](/agent/automations/catalog/) · [Who can chat](/agent/channels/who-can-chat/)