Receive email via IMAP in Omnifox
How to set up IMAP receiving on the email channel, with the actual fields, the test button, and what you need to know before connecting a mailbox that has history.
On the email channel, sending and receiving are configured separately and with different credentials. You can send through one server and receive through another. This guide covers IMAP receiving, the option where Omnifox connects to your mailbox and pulls the emails in.
Before you start
- Your mailbox's IMAP details: server, port, username, and password.
- If your provider uses two-step verification, you almost always need an app password, not your account password.
- Important: when you connect, Omnifox imports the unread emails already sitting in the folder. If the mailbox has years of unread messages, mark them as read before connecting.
Steps
- Go to Channels and open the email channel (or create one with Connect new channel → Email).
- Scroll down to the Receiving (incoming email) section.
- Under Receiving method, choose IMAP — connect to the mailbox and pull the emails.
- Fill in the fields:
| Field | What to enter |
|---|---|
| IMAP Host | The incoming server, for example imap.gmail.com. |
| Port | 993 by default. |
| IMAP Username | The full mailbox address. |
| IMAP Password | The mailbox password or the app password. |
| Encryption | SSL by default. TLS (STARTTLS) and None are also available. |
| Folder | INBOX by default. |
- If you want Omnifox to empty the mailbox as it imports, check Delete emails from the mailbox after importing them. It is unchecked by default.
- Click Test receiving (IMAP).
- Finish the wizard with Continue.
The IMAP Host, IMAP Username, and IMAP Password fields are shown in English.
Verify it
The Test receiving (IMAP) button connects, authenticates, and opens the folder. If everything is fine it answers "Incoming IMAP OK" with the server and the folder. If something fails it tells you what: missing details, the folder does not exist, or the connection was refused.
Then send a test email to that address from another account. It should show up in the Inbox within a couple of minutes.
How often the mailbox is checked
Omnifox checks IMAP mailboxes every 2 minutes and pulls at most 50 emails per channel on each pass. That works out to around 1,500 emails per hour per channel. Every message processed is marked as read in the mailbox (or deleted, if you turned that checkbox on).
After the first pass, the channel only pulls what is new: it stores a marker for the last imported email and continues from there.
Limits worth knowing
- Only one folder is read, the one you specify. It does not walk subfolders.
- Attachments larger than 25 MB are not downloaded: the name, type, and size are recorded, but not the file.
- Auto-replies are discarded. Out-of-office notices, mailing list messages, and automatic bounces do not reach the inbox and do not reopen conversations.
If something doesn't work
- "Incoming IMAP failed": check the username, password, and encryption. With two-step verification turned on, you almost always need an app password.
- "Folder not found": the name is case-sensitive and varies by provider; try
INBOX. - The channel shows as Error: three authentication failures in a row mark it that way. It recovers on its own as soon as a connection works again. Network drops and timeouts do not count.
- Nothing arrives even though the test passed: the emails may be landing in a subfolder because of a rule inside the mailbox itself.
Tips
- Use a dedicated mailbox (
support@,hello@) instead of the personal email of someone on the team. - If you would rather not hand over mailbox credentials, the alternative is the Webhook method, where your provider forwards the emails to an Omnifox URL.
Related articles
Related articles
-
WhatsApp (Meta) error codes: what they mean and what to do
A table of the most common Meta error codes when sending on WhatsApp (131026, 131047, 131049, 130497, 141006, 131031, 131056, 132000, 190, 368…) and how to fix each one.
-
How to connect Telegram
Connect a Telegram bot to your Omnifox inbox in minutes using BotFather.
-
Instagram and Facebook comments: reply and moderate from Omnifox
See and answer comments on your Facebook and Instagram posts and ads, publicly or privately, and set up automatic replies.
-
Sending and receiving videos on each channel: formats and size limits
Which videos you can send and receive on WhatsApp, Instagram, Messenger, Telegram, web chat and email, the real size limits, and what to do with a large video.
-
Move from WhatsApp QR to Coexistence or Cloud API
Once you're done testing with the QR code, move your number to the official connection: no caps, with templates and broadcasts, and no volume-based ban risk.