Micro service receiving emails and posting them to web hooks.
Download the binary from the Releases Page or build from source.
mailhook -hook-dir /etc/mailhook/hooks -listen :25
A hook directory contains a number of hook files with .yml extension.
A hook file includes a YAML encoded set of web hooks and email address patterns.
---
# catch mails to [email protected] and [email protected]
- hook: 'https://api.example.com/v1/mails'
emails:
- '[email protected]'
# catch mails to *@example.net and *@example.org
- hook: 'http://example.net/messages'
emails:
- '@example.net'
- '@example.org'
# catch all mails
- hook: 'http://example.net/fallback'
emails:
- '@'The request that will be sent to the HTTP endpoint will be encoded as multipart/form-data with the following payload:
| Field | Value |
|---|---|
mail[sender] |
SMTP sender address |
mail[recipient] |
SMTP recipient address |
mail[message][from][][name] |
Names taken from the From header |
mail[message][from][][email] |
Adresses takem from the From header |
mail[message][to][][name] |
Names taken from the To header |
mail[message][to][][email] |
Adresses takem from the To header |
mail[message][cc][][name] |
Names taken from the Cc header |
mail[message][cc][][email] |
Adresses takem from the Cc header |
mail[message][bcc][][name] |
Names taken from the Bcc header |
mail[message][bcc][][email] |
Adresses takem from the Bcc header |
mail[message][reply_to][][name] |
Names taken from the ReplyTo header |
mail[message][reply_to][][email] |
Adresses takem from the ReplyTo header |
mail[message][subject] |
Subject of the message |
mail[message][date] |
RFC3339 encoded date of the message |
mail[message][message_id] |
ID taken from the MessageID header |
mail[message][in_reply_to] |
ID taken from the InReplyTo header |
mail[message][references][] |
IDs taken from the References header |
mail[message][text] |
Text body of the message |
mail[message][html] |
HTML body of the message (can be empty) |
mail[message][attachments][] |
Attachments of the message |