Inbound routing

Receive emails at your domain and get clean JSON POSTed to your webhook.

Inbound routing turns incoming email into structured data. When someone replies to your campaign or emails a custom address on your domain, we receive the raw MIME message, parse it, and POST a clean JSON payload to your webhook endpoint.

Setup

  1. Enable receiving: In the dashboard under Domains, click on your verified domain and go to the Receiving tab to enable inbound routing.
  2. Publish MX records: Add the generated MX records to your DNS provider to route mail for this domain to us.
  3. Add a webhook: Create a webhook endpoint that listens for the `email.received` event.

Dedicated receiving domains

We recommend using a dedicated subdomain for inbound routing (e.g. `reply.yourdomain.com`) so its MX records don't conflict with your primary corporate email (Google Workspace, Office 365).

The payload

When an email arrives, we POST an `email.received` event containing the parsed subject, sender, recipient, and the body in both text and HTML. Attachments are extracted and made available for download via the API.