Handling inbound email with routes and webhooks

Receiving mail is as much a part of many apps as sending it, reply-by-email, support inboxes, parsing receipts. Here is how inbound works.

Enable inbound on a domain

On the domain's page, switch on inbound receiving. BookMySpot generates the MX records for you to publish; once they resolve, mail addressed to that domain arrives at your inbound stream.

Route matching

Routes decide what happens to each message. Match on recipient, sender or subject, and choose an action:

• Forward to another address.
• Store for retrieval via the API.
• POST the parsed message to a webhook in your app.

Webhook payloads

The webhook receives the parsed message, headers, text and HTML bodies, and attachments, so your app never has to speak SMTP. Verify the signature on each request to be sure it came from us, and return a 2xx quickly, heavy processing belongs in a background job.