Set up Email with SendGrid or Mailgun (API key)

How to connect the Email channel using a SendGrid or Mailgun API key, and when that beats plain SMTP.

Jun 25, 2026

What you'll set up

The Omnifox Email channel lets you send and receive email as just another conversation in your Inbox. You can connect it two ways: with an API provider or with traditional SMTP. This guide covers the API key option.

The Provider dropdown offers exactly three choices: SMTP, SendGrid, and Mailgun.

API key or SMTP — which should you pick?

  • API key (SendGrid or Mailgun): you paste a single key. Good deliverability, no ports to open. It's the simplest way to send at scale.
  • SMTP: asks for host, port, username, password, and encryption. Pick it if you already have a corporate mailbox, or if your provider isn't one of the two above.

API providers require a verified sending domain. Channels using their own authenticated SMTP are exempt, because your own server already authenticates the sender.

Requirements

  • A SendGrid or Mailgun account.
  • Your domain verified with that provider, with SPF and DKIM set up.
  • An API key generated in the provider's dashboard.

Steps

  1. In the side menu, open Channels and click Connect New Channel.
  2. Choose Email as the channel type.
  3. Enter the Channel Name — it's required before you can continue.
  4. Under Sending (outgoing mail), open the Provider dropdown and pick SendGrid or Mailgun.
  5. Paste your key into the API Key field.
  6. Fill in From Email (the sending address, e.g. [email protected]) and From Name (the name customers see, e.g. Support).
  7. Click Continue to save the channel.

The From Email address must belong to a domain verified with your provider. Otherwise SendGrid or Mailgun will reject the send.

Receiving email

Receiving is configured separately, under Receiving (incoming mail), with its own credentials. There are two methods:

  • Webhook — your provider forwards messages to an Omnifox URL. Copy the Inbound Webhook URL shown in the form and paste it into your provider's inbound section: Inbound Parse in SendGrid, Routes in Mailgun.
  • IMAP — Omnifox connects to a mailbox and pulls the messages in.

Verifying

  1. From the channel you just created, send a test email to one of your own addresses.
  2. Reply to it from your personal inbox.
  3. The reply should show up in the Omnifox Inbox.

If it doesn't work

  • Nothing goes out: check that the API Key is correct and has send permissions.
  • Messages land in spam or get rejected: the domain isn't verified (SPF/DKIM), or the From Email doesn't match the verified domain.
  • You get a verified-sending-domain warning: with SendGrid or Mailgun that requirement is mandatory. Verify the domain, or use a channel with your own SMTP.
  • Replies never arrive: the inbound webhook URL isn't set up correctly at the provider, or your MX records don't point to the inbound service.

Tips

  • Use a dedicated address like support@ or hello@ instead of someone's personal email, so all support stays in one place.
  • If you'd rather not depend on an external provider, the SMTP option works with any corporate mailbox.

Related articles

Was this helpful?

Related articles

Message us on WhatsApp