Skip to main content
Mailrify can receive emails sent to your verified domain and emit an email.received event. You can use this event in workflows for support automation, routing, and custom integrations.

​
How it works

When someone sends an email to your domain (for example [email protected]), Mailrify:
  1. Receives the email through inbound processing
  2. Creates or updates a contact for the sender
  3. Triggers an email.received event for workflows
  4. Includes inbound metadata in the event payload

​
Set up inbound email

1

Verify your domain first

Domain verification is required before inbound processing can be configured. Follow Verifying domains.
2

Add the inbound MX record

Open Domains in the dashboard, expand your domain, and find the Inbound Email DNS section.Add the record shown there. It uses this pattern:
  • Type: MX
  • Name: <your-domain>
  • Value: inbound-smtp.<region>.amazonaws.com
  • Priority: 10
Multiple MX recordsIf you already use MX records for another mailbox provider (for example Google Workspace or Microsoft 365), plan DNS carefully. A domain can only have one effective inbound routing setup. Consider using a subdomain (e.g., mail.yourdomain.com) if you need to maintain both services.
3

Wait for DNS propagation

DNS changes can take a few minutes up to 48 hours.
dig MX yourdomain.com
Confirm the response includes inbound-smtp.<region>.amazonaws.com.

​
Use email.received in workflows

Create a workflow with email.received as the trigger to react to inbound mail.

​
Event payload fields

FieldTypeDescription
messageIdstringUnique identifier for the received message
fromstringEmail address of the sender
fromHeaderstringFull “From” header including display name
tostringPrimary recipient email address
subjectstringEmail subject line
timestampstringISO 8601 timestamp when the email was received
recipientsstring[]All recipient email addresses
hasContentbooleanWhether the email body was captured
spamVerdictstringSpam check result (e.g., “PASS”, “FAIL”)
virusVerdictstringVirus scan result (e.g., “PASS”, “FAIL”)
spfVerdictstringSPF authentication result
dkimVerdictstringDKIM authentication result
dmarcVerdictstringDMARC authentication result
processingTimeMillisnumberTime taken to process the email
You can access these fields in your workflow using variable syntax, for example: {{event.subject}} or {{event.from}}.

​
Multi-project domains

If the same verified domain exists in multiple projects, Mailrify processes inbound mail for each matching project and emits separate email.received events per project. Each project will:
  • Create/update the sender as a contact in that project
  • Trigger the email.received event in that project
  • Run any workflows configured for that event
This allows you to segment inbound email handling across different projects if needed.

​
Current limitations

Email body contentCurrently, the email body content is not stored or made available in the event data. Only metadata (sender, subject, recipients, timestamps, and security verdicts) is captured. The hasContent field indicates whether body content was present, but the content itself is not accessible in workflows.
  • Catch-all addresses: Mailrify receives emails sent to any address at your verified domain (e.g., [email protected]). You can use workflow conditions to route emails based on the to field.
  • Attachments: Attachments are not stored or exposed.
  • Email size: The maximum message size limit for inbound emails is 40 MB.

​
Security considerations

Mailrify captures several security verdicts for each incoming email:
  • SPF (Sender Policy Framework): Verifies the sender’s mail server is authorized
  • DKIM (DomainKeys Identified Mail): Validates the email hasn’t been tampered with
  • DMARC (Domain-based Message Authentication): Combines SPF and DKIM for additional validation
  • Spam verdict: Mailrify’s spam detection result
  • Virus verdict: Mailrify’s virus scanning result
You can use these verdicts in workflow conditions to automatically filter or quarantine suspicious emails before processing them.

​
Troubleshooting

​
Emails not being received

  1. Check DNS propagation: Verify the MX record is correctly set using dig MX yourdomain.com
  2. Verify domain: Ensure your domain is fully verified in Mailrify (all DKIM, SPF, and MX records for sending)
  3. Check workflow: Create a simple test workflow with just an email.received trigger and a webhook to verify events are being generated
  4. Check sender: Try sending from a different email provider as some may cache DNS records

​
Duplicate events

If you have the same domain verified in multiple projects, you will receive duplicate email.received events (one per project). This is expected behavior. Use project-specific workflows to handle this.

​
Security verdicts failing

If incoming emails consistently show failing security verdicts:
  • SPF failures: The sender’s domain may not have SPF configured correctly
  • DKIM failures: The sender’s domain may not have DKIM configured, or the email was forwarded/modified in transit
  • DMARC failures: The sender fails both SPF and DKIM checks
These are issues with the sender’s configuration, not your Mailrify setup. You can choose to process these emails anyway or filter them using workflow conditions.