How does it work?

When you create a hook, anything sent (or forwarded) to the email address you make will be converted to a post request and passed to your destination.

Make a recipient

(e.g. myhook@emailhooks.xyz)
Send email to this recipient directly or forward it email from your own domain

Tell it where to go

(e.g. http://example.com/mail)
Point the hook to your application

Handle like a normal request

Emails get forwarded to your endpoint where you can handle them like a normal JSON post request:

POST /email HTTP/1.1
Host: example.com
Content-Type: application/json
Content-Length: 371
X-Hook-Signature: 5893fa3c6eead836d3742bdeabd4c4914c438ffb

{
  "sender": "tom@example.com",
  "to": ["hook@emailhooks.xyz"],
  "cc": ["elisha@example.com"],
  "date": "Fri, 10 Mar 1876 15:54:49 -0500",
  "subject": "Urgent!",
  "html_body": "<html><div dir=\"ltr\">Mr. Watson, come here — I want to see you.</div></html>",
  "plain_body": "Mr. Watson, come here — I want to see you.",
  "attachments": []
}