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.

Aug 19, 2026

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

  1. Go to Channels and open the email channel (or create one with Connect new channel → Email).
  2. Scroll down to the Receiving (incoming email) section.
  3. Under Receiving method, choose IMAP — connect to the mailbox and pull the emails.
  4. 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.
  1. 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.
  2. Click Test receiving (IMAP).
  3. 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

Was this helpful?

Related articles

Message us on WhatsApp