Email Processing
Email Processing turns inbound email into tickets, ticket updates, notifications, and other automations. An email arrives at one of your mailboxes, the system evaluates the rules attached to that mailbox, and any matching rule runs its action steps in order.
This product is branded differently depending on which PSA you use:
| Your PSA | Product name |
|---|---|
| Autotask | Email2AT |
| ConnectWise PSA | Email2CW |
| HaloPSA | Email2Halo |
The console, history, and configuration are identical across the three brandings. PSA-specific behaviour is documented inline where it matters.
When to Use Email Processing
Use Email Processing when a third party sends email that should drive work inside your PSA or other business systems:
- Customer support requests arriving at
[email protected] - Monitoring alerts from RMM, backup, or network monitoring tools
- Notifications from vendors (contract renewals, license expirations, spam reports)
- Forwarded email from technicians that needs to become a ticket or opportunity
If the trigger is not an email (a schedule tick, a public form submission, a PSA event), see Scheduled Tasks, Forms, or Workflows.
How It Works
When an email arrives, Email Processing walks four levels:
Domain
└── Mailbox
└── Rule(s)
└── Action Step(s)
Domain
Every inbound email domain belongs to one account. This includes hosted subdomains (for example, your-company.onmspi.net) and custom domains you point to MSPintegrations with an MX record. When an email arrives, the system matches the domain to your account and begins looking for a mailbox.
Mailbox
A mailbox is a specific email address within a domain (for example, [email protected]). Email Processing supports two mailbox types:
- Hosted Mailboxes: run on MSPintegrations infrastructure. Email is delivered directly by SMTP. Fastest to set up, best latency, recommended for automated senders like RMM and backup tools.
- Remote Mailboxes: MSPintegrations polls your own Microsoft 365, IMAP, or POP mailbox and processes the messages it finds. Use this when your existing support address needs to stay where it is.
Rules
A rule is a named container for one or more action steps. Rules attached to a mailbox are evaluated top-to-bottom in order. Every rule that matches fires unless a Stop action halts processing.
Each rule has an optional Expression that controls whether it fires at all. If the expression is empty, the rule fires for every email.
Learn more → Expression Builder
Action Steps
Inside each rule, action steps execute top-to-bottom. Each step can also have its own expression. The output of each step is stored in a named variable and is available to every subsequent step in the same rule.
Variables Available in Email Processing
| Namespace | Populated by | Purpose |
|---|---|---|
email | System | All inbound email properties (subject, from, body, recipients, and so on) |
meta | System | Processing run metadata (meta.history.id, meta.remote.id for remote mailboxes) |
custom | You | Working data within a single rule (reset between rules) |
global | You | Data that must persist across rule sets in the same run |
Full details: Variable Namespaces.
The Console
Email Processing lives under Email2AT (or Email2CW / Email2Halo) in the console sidebar. From there you can:
- Home: landing page with a quick overview of your mailboxes.
- All Mailboxes / Hosted Mailboxes / Remote Mailboxes: manage mailbox configuration and rules.
- Email History: review every message processed by any mailbox, with the full execution log and replay.
- Rule Library: share and import rule templates.
Start Here
- Create Your First Mailbox: a full end-to-end walkthrough that builds a support mailbox with the Update-then-Create ticket pattern.
- Email Processing Best Practices: routing, testing, and common configuration guidelines.
- Core Concepts: the mental model shared by every product.
Next Steps
- Build a real-world workflow with the tutorials below (monitoring alerts, PRTG alerts, UniFi alerts, forwarded emails to opportunities, and more).
- Diagnose problems in the troubleshooting guides guides.
- Set up your PSA connection in Connections → Autotask or Connections → Microsoft 365.