Skip to main content

Email (IMAP/SMTP)

Connect any mailbox over IMAP and SMTP: Fastmail, iCloud, your host's mail, or Gmail with an app password. Search its mail as knowledge, read and answer it in Mail, let an agent answer an inbox, or let agents send email.

The Email (IMAP/SMTP) connection page

:::tip Google Workspace or Microsoft 365? Use Google Gmail or Microsoft Outlook instead: they sign in with Google or Microsoft, with no password to keep. Microsoft 365 no longer accepts passwords over IMAP at all. :::

Before you start​

You need the mailbox's address, its password (or an app password), and its provider's IMAP and SMTP server names. Your provider's help pages list them under "mail settings" or "set up a mail app".

With two-step verification on, most providers refuse the account's password: make an app password instead.

  • Google: Google Account → Security → App passwords.
  • iCloud: account.apple.com → App-Specific Passwords.

Set it up​

  1. Integrations → Add → Email (IMAP/SMTP).

  2. Fill in the account:

    FieldWhat goes there
    Username / addressUsually the full email address.
    Password or app passwordEncrypted, never shown again.
    From addressAn address this account may send as (defaults to the username). Most servers reject any other.
    From nameWhat recipients see beside the address, e.g. Acme Support.
  3. Fill in Servers:

    FieldUsual value
    IMAP hostimap.gmail.com, imap.fastmail.com, imap.mail.me.com
    IMAP port / IMAP over TLS993, on. (143 with TLS off only for a server without TLS.)
    SMTP hostsmtp.gmail.com, smtp.fastmail.com, smtp.mail.me.com
    SMTP port / SMTP over TLS587, off (STARTTLS). 465, on, when the provider says SSL/TLS.
  4. Save, then Test.

Let an agent answer an inbox​

Under Answering, turn on Agents answer this inbox, pick the Inbound folder (INBOX, or a subfolder as the server spells it: INBOX/Support or INBOX.Support) and the Agent (empty: the default agent). New mail arriving there gets an answer from that agent.

Let agents send email​

Turn on Agents may send email. Agents can then propose emails from this mailbox; each is sent only once a person approves it in Review.

Mail and knowledge​

Show in Mail, classes, folders, how far back to read, readers and attachments are the same for every mailbox: see Mailboxes. For IMAP, the folders Mail reads are also the ones ingested as knowledge.

Troubleshooting​

ErrorUsually
Authentication failedTwo-step verification is on: use an app password.
Connection timed outWrong host or port, or TLS on for a port without it (or the reverse).
Sending refusedThe From address is not one this account may send as.
Folder not foundSpell the folder as the server does, separator included.