douglasanpa/mailhook repository overview

⁠mailhook

Micro service receiving emails and posting them to web hooks.

⁠Install

Download the binary from the Releases Page⁠ or build from source.

⁠Usage

mailhook -hook-dir /etc/mailhook/hooks -listen :25

⁠Hook Directory

A hook directory contains a number of hook files with .yml extension.

⁠Hook File

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:
    - '@'

⁠Payload

The request that will be sent to the HTTP endpoint will be encoded as multipart/form-data with the following payload: