Skip to main content

Receive Email

Inbound email is delivered to your mailboxes and exposed through the API and webmail.

How it works​

  1. You add a domain and point its MX records to PurpleToad Mail.
  2. PurpleToad Mail receives the message, runs spam and virus checks, and stores it.
  3. The message is available via the API, webmail, or forwarded through a webhook.

List inbound messages​

curl https://api.purpletoadmail.com/api/v1/inbound/messages \
  -H "Authorization: Bearer pt_live_your_key_here"

Read a message​

curl https://api.purpletoadmail.com/api/v1/inbound/messages/{message_id} \
  -H "Authorization: Bearer pt_live_your_key_here"

Webhooks for inbound mail​

Subscribe to the inbound_email event to receive a JSON payload every time a message arrives. The payload includes envelope data, headers, plain-text and HTML bodies, and attachment metadata.