Troubleshooting: Email won't send or receive

Step-by-step diagnosis when your Email channel stops sending or receiving: credentials, port, TLS, and the usual Gmail and Outlook gotchas.

Jun 25, 2026

When to use this guide

Your Email channel shows as connected but messages don't go out, don't come in, or both. Here we split the two sides — sending (SMTP) and receiving (webhook) — because they almost always fail for different reasons.

First: is it sending or receiving?

  • Customers don't receive your replies → a sending / SMTP problem.
  • Customer emails never appear in the Inbox → a receiving / webhook problem.

Open Channels, go into your Email channel and check its status, then follow the matching section.

Email won't send (SMTP)

  1. Credentials: go back to Channels → your channel → edit and re-type Username and Password. On Gmail and Outlook a normal password almost never works.
  2. Port and encryption: use Port 587 with TLS encryption (STARTTLS), or Port 465 with SSL. Mixing 465 with TLS is the most common mistake.
  3. Correct SMTP Host: smtp.gmail.com for Gmail, smtp.office365.com for Outlook/Microsoft 365.
  4. Consistent From Email: the From Email address should belong to the same account that authenticates; many servers refuse to send "on behalf of" another address.

Email won't receive (webhook)

  1. Confirm the Inbound Webhook URL (https://omnifox.io/api/webhooks/email) is configured at your inbound provider (SendGrid Inbound Parse or Mailgun).
  2. Check the MX record of the receiving domain or subdomain.
  3. The address customers write to must exactly match the channel's From Email: Omnifox routes inbound mail by the recipient.

Gmail / Google Workspace

  • Turn on 2-step verification and generate an app password; use it as the channel Password (not your normal one).
  • Still can't send? Check your account for a "blocked sign-in attempt" alert and approve it.

Outlook / Microsoft 365

  • Microsoft is disabling basic auth (SMTP AUTH). If your tenant has it off, plain SMTP sending will fail; ask your admin to enable SMTP AUTH for the mailbox or use an account that allows it.
  • Correct host: smtp.office365.com, port 587, TLS.

If none of that works

  • Send a test email and open the conversation: if a delivery error message appears, copy the exact text — it usually names the cause (auth, relay, TLS).
  • Recreate the channel from scratch in case a credential was saved half-way.

Tips

  • Store sending credentials in a manager: rotating app passwords without updating them in Omnifox is the most common silent failure.
  • Test sending and receiving separately; fixing one doesn't guarantee the other.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp