Taifa MailTaifa Mail Docs
Email Forwarding

Email Forwarding

Route incoming emails from your domain to any email address using Taifa Mail forwarding rules.

Email forwarding lets you receive emails at addresses on your domain and automatically route them to one or more destination addresses. For example, forward hello@yourdomain.com to your personal Gmail without running a full mailbox.

Prerequisites

Two things must be true before you can create a forward:

  1. The domain is verified for sending. See Domain Setup.
  2. The domain's MX record points to Taifa Mail. Verifying a domain for sending does not add an MX record, so you usually need to add this separately.
Record TypeNameValuePriority
MX@ (root domain)mx1.govconnect.ke10

Changing MX records affects where all email for your domain is delivered. If you currently receive email through another provider (e.g. Google Workspace, Zoho), adding Taifa Mail MX records will redirect incoming mail away from that provider. Plan your migration carefully.

Setting up a forward

  1. Go to Forwarding in the sidebar.
  2. Click Add Forward.
  3. Choose the domain the forward belongs to. It must be a verified domain on your account.
  4. Enter the source address - the address on that domain that receives mail, for example hello@yourdomain.com. The address's domain must match the chosen domain.
  5. Enter one or more destinations (see below).
  6. Click Save.

The source address does not need to be a created sender address - it only needs to be on a verified domain. Each source address can have one forwarding rule; adding a second rule for the same source is rejected.

Forwarding rules take effect once your MX record has propagated.

You cannot create a forwarding rule until the domain's MX record points to Taifa Mail. The app checks this when you add a forward and blocks the rule if no MX record routes the domain's mail to Taifa Mail - incoming mail would never reach Taifa Mail otherwise.

Destinations

A forward can deliver to two kinds of destination:

  • Email address - the message is relayed on to that mailbox with the original headers preserved.
  • HTTPS URL - the message is delivered to a URL as an HTTP request, so your application can process inbound mail programmatically (webhook-style).

A forward needs at least one destination, and a single rule can have several destinations of either kind; every destination receives a copy. The total number of destinations per rule is capped by your plan (see Limits).

How it works

When an email arrives at hello@yourdomain.com:

  1. Taifa Mail's mail server accepts the incoming message.
  2. The forwarding rule matches the recipient address.
  3. The message is forwarded to each destination address with the original headers preserved.
  4. A forwarding log entry is created.

Managing a forward

You can update a forward's destinations or toggle it on or off without deleting it. A forward must always keep at least one destination - clearing every destination is rejected. Deleting a forward removes the rule entirely.

Forwarding vs. the inbox

Forwarding relays incoming mail on to an external destination. If instead you want to read incoming mail inside Taifa Mail, use the Inbox. Both can run at once - a message can be stored in the Inbox and forwarded.

Viewing forwarding logs

On the Forwarding page, open the logs to see a list of all forwarded emails. Each log entry records:

  • The original sender (from)
  • The source address the mail arrived at (original to)
  • The destination it was forwarded to (forwarded to)
  • The subject line
  • The message size
  • The timestamp

You can filter the logs by a specific forwarding rule. Logs are paginated.

Forwarding stats

The Forwarding page also shows stats for the last 30 days: the total number of emails forwarded this month, and a breakdown of how many each forwarding rule handled.

Limits

The number of forwarding rules and destination addresses per rule depends on your plan:

PlanForwarding RulesDestinations per Rule
Free11
Starter32
Pro255
BusinessUnlimitedUnlimited

On this page