# IMAP

Connect any IMAP and SMTP mailbox, such as iCloud, Yahoo, Fastmail, GMX, Zoho or your own domain, and use it through the same email API as Gmail and Outlook.

Connect any mailbox that speaks IMAP and SMTP and use it with the same `/v1/email` endpoints, inbox and webhooks as Gmail and Outlook.

## Quick reference

A connected mailbox uses `platform: "imap"` and represents one address. It has email only, with no calendar, files or contacts.

| Property | Value |
|----------|-------|
| Platform value | `imap` |
| Providers | iCloud, Yahoo, AOL, Fastmail, GMX, WEB.DE, mail.com, Zoho, Yandex, Purelymail, and any server with IMAP and SMTP |
| Auth | The mailbox password or an app password, stored encrypted |
| Email | List, search, read, send, reply, move, trash, drafts and scheduled send. 200 sends a day |
| Labels | None: organize with folders |
| New mail | Polled every minute, so events arrive one to two minutes late |
| Inbox | Inbound and sent mail appears as conversations, with `message.received` |
| Webhooks | `message.received`, `email.*`, `account.disconnected`, `account.connected` |
| List the accounts | `GET /v1/accounts?platform=imap` |

## Before you start

- Gmail, Google Workspace, Outlook.com and Microsoft 365 connect as [Google](/platforms/google) or [Microsoft](/platforms/microsoft) accounts, never over IMAP. The connect flow sends them there.
- Most providers need an app password from mail apps, and some need IMAP access turned on first. Discovery tells you which.

## Connect

Send the user to the hosted page from `GET /v1/connect/email`, or connect from your own form with `POST /v1/email/imap/accounts`. See [Connect](/platforms/imap/connect).

## Common errors

| Code | Fix |
|------|-----|
| `app_password_required` | Create an app password at the provider and use it instead |
| `imap_disabled` | Turn on IMAP access in the mailbox settings |
| `account_reconnect_required` | Send the user to `details.reconnectUrl` |

## In this section

<PlatformPages platform="imap" />

## Related

- [Google email](/platforms/google/email)
- [Microsoft email](/platforms/microsoft/email)
- [Inbox webhooks](/webhooks/inbox)