mailhook

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 tom@example.com and tom+arbitrary-tag@example.com
- hook: 'https://api.example.com/v1/mails'
  emails:
    - 'tom@example.com'

# 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: