Send email via allowmaild

allowmaild sends plain-text email to recipients pre-approved in its root-owned config. You name a recipient alias; the daemon resolves the address, builds the message, and delivers it with credentials only it can read. You cannot supply an email address, HTML, attachments, CC/BCC, or custom headers — the API rejects them by design, so don't attempt workarounds.

How to send

Default: use the bundled script. It generates the idempotency key, builds the JSON safely, and maps the outcome to exit codes.

scripts/send-email.sh <alias> <subject> [body-file]    # body from stdin if no file

Example:

echo "Backup completed at $(date)." | scripts/send-email.sh self-gmail "Nightly backup OK"

Exit codes: 0 sent, 2 failed (safe to retry — just rerun the script; it uses a fresh key), 3 ambiguous (do not retry), 4 daemon rejected the request (inspect the JSON on stdout), 1 local/usage error. Set ALLOWMAIL_SOCKET to override the socket path.