FAQ

FAQ#

Why is the Route Not Triggering?#

There are a few key conditions that must be met for a route to trigger properly:

  • ✅ Domain is Verified Make sure you’ve added the DNS TXT token correctly. Your domain should show as Verified inside the MailTrigger UI.

  • ✅ Route is Enabled Double-check that the route’s Enabled toggle is turned on.

  • ✅ Rule Filters Pass

    • If Match All is selected: all rules must match.

    • If Match Any is selected: at least one rule must match.

    • If there are no rules and Match Any is selected: the route triggers on every message.

  • ✅ Authentication Checks Pass (or are allowed)

    Note

    If SPF/DKIM fails and the domain’s DMARC policy is set to reject, the message will be rejected immediately by the SMTP server. → No route logs. No actions.

    If DMARC is set to quarantine or none, the message is still accepted, but:

    • Route logs will show status: quarantined

    • Actions will not be executed

What Are SPF / DKIM / DMARC Checks?#

These are email authentication technologies used to combat spoofing and phishing:

  • SPF (Sender Policy Framework) Declares which IP addresses or servers are authorized to send email for your domain. Receiving servers check if the sender’s IP is allowed.

  • DKIM (DomainKeys Identified Mail) Adds a digital signature to your emails. Receivers verify it using your domain’s public DKIM key in DNS. This ensures the message wasn’t tampered with.

  • DMARC (Domain-based Message Authentication, Reporting & Conformance) Defines what to do if SPF and/or DKIM checks fail. It enforces policy (none, quarantine, or reject) and lets domain owners receive failure reports.

Why Was a Route Marked as Quarantined?#

This happens when:

  • The message fails SPF or DKIM,

  • And the domain’s DMARC policy is set to quarantine or none.

Important

In this case, MailTrigger:

  • Accepts the email

  • Logs the route as quarantined

  • Skips action execution

Why Are There Default “SMTP to Origin” and “Relay to Origin” Routes?#

To ensure mail keeps flowing even without extra setup, MailTrigger adds two default routes when you create a new mailbox:

  • SMTP to Origin Handles outgoing mail via your mailbox’s original SMTP host. So you can send mail right away, no need for extra config.

  • Relay to Origin For receiving mailboxes: this forwards incoming mail to your original mail provider. Ideal if you still want to keep your old inbox while using MailTrigger.

Note

These default routes are optional. You can disable or customize them anytime to build advanced logic.

Contents