Inbound email
Receive email and have Mailhuset parse it and POST it to your app: for support inboxes, reply-handling, or turning emails into tickets.
How it works
You create an inbound route (an address Mailhuset receives mail at). When mail arrives, Mailhuset parses it (headers, text/HTML bodies, attachments) and POSTs the structured result to your webhook URL.
Two kinds of route
Open Inbound → Add route and pick a type:
- Hosted address (no DNS setup): Mailhuset gives you an address to receive at.
Fastest to start: nothing to configure at your DNS provider.
- Your own inbound domain (e.g.
inbound.yourdomain.com): point its MX
records at Mailhuset so you receive at your own branded addresses. Mailhuset shows the exact MX records to add.
Set the Webhook URL where parsed mail should be delivered.
The parsed payload
Each received message is POSTed as JSON: sender, recipients, subject, the text and HTML bodies, and attachments (small ones inlined; larger ones referenced). Your endpoint should return 2xx quickly and process asynchronously.
Tips
- Secure your endpoint (validate it's really Mailhuset before acting), and make
it idempotent. The same message may be retried.
- Very large attachments are referenced rather than inlined; fetch them if needed.
Related
- Webhooks: the same delivery/retry model applies.
Need help? Email support@mailhuset.com.