New guide: how to warm up a dedicated IP without hurting your reputation. Read now →
Log in
MigoSMTP
Inbound Email

Receive and process incoming email

Turn replies and incoming messages into structured events your application can act on.

AI intent classification sorts replies, out-of-office notes and complaints for you.

Inbound domain
TYPE
NAME
VALUE
MX
replies
mx.migosmtp.com
TXT
replies
v=spf1 include:migosmtp.com ~all
CNAME
_verify.replies
verify.migosmtp.com
Waiting for DNS
MX record
Any subdomain
Point your MX at usAdd an MX record for a subdomain, such as replies.example.com, and mail to it now arrives at MigoSMTP.
Customer
mx.migosmtp
From
Subject
Attachment
{
"from": "a@b.com",
"subject": "Help",
"text": "Hi team…",
"attachments": 1
}
POST to your webhook
Structured
Attachments
Every message becomes dataThe raw email is split into sender, subject, text, HTML and attachments, and returned as clean JSON.
Inbound headers
Received: from mx.gmail
X-Spam-Score: 0.4
Authentication-Results:
spf=pass dkim=pass
dmarc=pass
Return-Path: <a@b.com>
Content-Type: multipart
Subject: Help
Spam · score 0.4Low risk
Auth · SPF and DKIM passTrusted
Size · [n] KBWithin limit
SPF pass
DKIM pass
DMARC pass
Spam score
Auth results
Screened before it reaches youSpam score, SPF and DKIM results travel with each message so your code can decide what to trust.
Inbound mail
Signed POST
/inbound
200 OK
Helpdesk
200 OK
Workflow
Retry in 30s
Webhook
Retries
Posted to your endpointParsed messages are POSTed to your webhook with retries, so tickets, replies and workflows start instantly.
GET /v1/inbound/msg_[id]
GET /v1/inbound/msg_[id]
Accept: application/json
Response
200 OK
{ "attachments": [
{ "url": "…" } ] }
Short-lived links
Attachment ready
Pull model
Signed URLs
Fetch attachments on demandLarge attachments stay in storage until you ask, keeping webhook payloads small and fast.
Inbound classifier
AI
“Where is my order?”Support request
Support
“Invoice attached”Billing
Finance
“Please unsubscribe me”Opt-out
Suppress
“Maybe next quarter…”Unclear
Human
Intent detection
Human fallback
AI reads replies and routes themEach inbound message is classified by intent, then sent to the right queue or webhook. Low-confidence ones go to a human instead of guessing.
Point MX
Parse
Screen
Deliver
Fetch
AI router
Inbound webhook payloadSample
{
  "event": "inbound",
  "from": "customer@example.com",
  "to": "support@reply.yourdomain.com",
  "subject": "Re: Your order",
  "text": "Thanks, that works for me.",
  "attachments": []
}
SMTP relayREST APIWebhooksDedicated IPsDKIM signingInbound parseTemplatesAnalyticsSuppression listsReputation monitoringEmail validationTeam roles and audit logSMTP relayREST APIWebhooksDedicated IPsDKIM signingInbound parseTemplatesAnalyticsSuppression listsReputation monitoringEmail validationTeam roles and audit log
Capabilities

Handle replies like any other event

Inbound domains

Point an MX record at MigoSMTP for a subdomain you choose.

Parsed to JSON

Headers, body and attachments arrive in a clean structure.

Routing rules

Send different addresses to different endpoints.

Attachment handling

Receive files with size limits you control.

Spam and virus checks

Screen incoming mail before it reaches your app.

Signed delivery

Verify each payload came from us.

How it works

STEP 1

Add an inbound domain

Publish the MX record for a subdomain.

STEP 2

Create a route

Match an address pattern and choose a webhook.

STEP 3

Handle the payload

Your app receives each message as JSON.

See it in action

One platform from first send to inbox

Switch between stages to see what you control at each step. Illustrative interface with sample data.

app.migosmtp.com / sendSample data
Queued
[n]
Sent
[n]
Rate
[n/s]
acceptedmessage to you@example.com
acceptedmessage to team@example.com
queuedbatch of [n] recipients
acceptedmessage to ops@example.com
Reply handling

Support inboxes, reply tracking and email-to-app flows

Use inbound routes to capture replies to transactional email, create tickets or feed workflows.

  • Per-route webhook endpoints
  • Retry on failure with backoff
  • Searchable inbound logs
  • Size and type limits
At a glance
SetupMX record on a subdomain
DeliverySigned webhook
FormatJSON with parsed fields
Limits[Confirm message and attachment size]
Overview

What is inbound email?

Use cases

Common inbound email use cases

Support inbox to ticket

Route support@ on a reply subdomain to your helpdesk endpoint. Each email becomes a ticket with sender, subject and attachments, without polling a mailbox. No polling needed.

Tracking replies to transactional mail

Set a reply-to on a reply subdomain with a token in the address. When someone responds, inbound email routing ties the reply to the right order or conversation.

Email-to-app uploads

Let users forward invoices or documents to a unique address. Parsed attachments arrive at your endpoint, ready to store or process, within the size limits you configure.

Handling auto-replies and unsubscribes

Capture out-of-office notices and unsubscribe requests sent by reply, then update contact status automatically so you stop mailing people who asked you to stop. Quiet clean-up improves long-term list health.

AI features

AI-assisted inbound email

Classify

Intent classification

Each inbound message can be labelled as a genuine reply, out-of-office, unsubscribe request, complaint or sales enquiry. You map labels to routes, and low-confidence items go to a person.

Assist

Suggested reply drafts

For support routes, the assistant drafts a response from your knowledge base. A human reviews and sends it; nothing goes out automatically unless you configure that rule yourself.

Copilot

Thread summaries

Long reply chains are condensed into a short summary and a suggested next action, helping agents pick up conversations quickly. Original messages stay available in the logs.

Risk

Spam and abuse scoring

AI risk scoring complements spam and virus checks by rating suspicious inbound messages. You choose whether high-risk items are quarantined, flagged or still delivered. Humans stay in charge of every decision.

AI features are assistive: classification and drafts support your workflow, and you decide the routing rules and what is sent. [Confirm which AI features are available at launch.]

Best practices

Best practices for inbound email

Use a dedicated subdomain

Put the MX record on a subdomain like reply.yourdomain.com so your normal mailboxes keep working and inbound traffic stays isolated.

Verify every signature

Check the signature header before processing a payload. Treat unsigned requests as untrusted, since anyone could post to a public URL.

Acknowledge fast, process later

Return a success response quickly and queue the work. Slow handlers trigger retries and duplicate deliveries. Queue the payload for later processing.

Make handlers idempotent

Retries can deliver the same message twice. Deduplicate on message ID so replays from the logs never create duplicate tickets.

Set attachment limits deliberately

Decide maximum size and allowed file types per route. Rejecting oversized or unexpected files early protects downstream systems.

FAQs

Inbound email: frequently asked questions

What is inbound email parsing?

Inbound email parsing receives email sent to an address you control and converts it into structured data, usually JSON with sender, subject, body and attachments. Your application gets it by webhook, so it can act on messages without running a mail server.

How do I receive email in my app with MigoSMTP?

Add an inbound domain, publish the MX record for a subdomain, create a route matching an address pattern, and point it at your HTTPS webhook. Each incoming message is posted to that endpoint as signed JSON. Pick a name that is easy to recognise.

Can I receive email on my main domain?

We recommend a dedicated subdomain so your regular mail is not affected. An MX record sends all mail for that name to the receiving service, so using the root domain would redirect your normal mailboxes. Review the delivery log for details.

What happens if my webhook endpoint is down?

Deliveries are retried, and you can replay them from the inbound logs once your endpoint recovers. [Confirm retry schedule.] Return a success response only after you have safely received the payload. This is safest when your endpoint is idempotent, because a replayed delivery then changes nothing a second time.

Are attachments included in the payload?

[Describe attachment delivery format.] Size and type limits are configurable per route. [Confirm message and attachment size.] Attachments are typically described in the payload with file name, type and size, and delivered either inline or by secure link, depending on size. Test with a few real files to see how your handler should treat them, and set strict size limits per route.

What is the difference between inbound email and webhooks?

Inbound email handles messages sent to you and posts them to your endpoint. Webhooks more broadly report events about messages you sent, such as delivered or bounced. Inbound uses webhooks as its delivery mechanism, so the same signature checks apply.

Does AI read my inbound email?

Only if you enable it. AI classification and summaries run on messages for routes where you turn them on, and results are suggestions you can map to rules. Human review stays available. [Confirm which AI features are available at launch.]

Are inbound messages scanned for spam and viruses?

Yes, incoming mail can be screened before it reaches your application, and you choose how flagged messages are handled. [Confirm scanning behaviour and engines.] Scanning protects downstream systems from malware and obvious junk. You choose whether flagged messages are rejected, tagged or quarantined for review, and every decision is recorded in the logs, which keeps handling auditable. Check your route settings for options.

Can I receive on my main domain?

We recommend a dedicated subdomain so your regular mail is not affected.

What if my endpoint is down?

Deliveries are retried, and you can replay them from the logs.

Start sending in minutes.

Create an account, add your domain and send your first email.