DocsInbound email

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.