FileMailer-FM Module #
Put every message into FileMaker — automatically, safely, and in real time.


A Spring Boot service that keeps IMAP mailboxes continuously synchronized with a FileMaker database, archives attachments, and exposes a clean REST API for reading, composing, and sending email — turning any FileMaker solution into a full email back-office.
Overview #
FileMailer-FM bridges standard IMAP/SMTP servers and a FileMaker database. Emails, folders, and attachments flow into FileMaker automatically; outgoing mail, drafts, and replies are sent back out through SMTP — all driven through a documented REST API.
It is designed for organisations that need to centralise email handling, build searchable archives inside FileMaker, and automate mail-driven workflows without writing IMAP plumbing themselves.
Key Features #
IMAP Synchronization #
- UID-based incremental sync — only new messages are fetched each cycle
- IMAP IDLE push notifications for real-time delivery (per-account, with server-capability detection)
- Scheduled reconciliation as a safety net against missed updates
- Multi-folder support with automatic detection, configurable exclusions (Trash, Spam, Junk…) and auto-restoration of folders that reappear on the server
Attachment Handling & Archiving #
- Attachments extracted automatically during sync
- Hybrid storage: filesystem tree and FileMaker container fields
- Configurable size limits and nested directory layout
- HTTP access to stored files via a
/mailbox/{account}/{folder}/{email}/{filename}endpoint
Outgoing Mail #
- Draft creation and editing with full message composition
- Attachments can be added to drafts before sending
- Send, resend, and forward messages through SMTP (SSL 465 / STARTTLS 587)
- Multiple SMTP configurations per account
Multi-Account Management #
- Unlimited email accounts managed side by side
- Independent IMAP and SMTP configuration per account
- Soft-delete with configurable retention — emails are never silently destroyed
Security #
- IMAP and SMTP credentials encrypted with AES-256-GCM before being stored
- HTTP Basic authentication on all API endpoints (Spring Security)
- Transactional writes for data integrity
Integration #
- RESTful JSON API with full Swagger / OpenAPI documentation
- RapiDoc UI alongside Swagger UI
- Type-safe external configuration (no JAR rebuild required)
Use Cases #
- Email archiving & compliance — every incoming message preserved in FileMaker
- Customer communication history — link emails to customer records in FileMaker
- Workflow automation — trigger FileMaker scripts from incoming messages
- Multi-mailbox operations — unify corporate, support and sales addresses
- Attachment processing — automatic extraction and storage of documents
Technical Specifications #
Stack #
- Java 17+
- Spring Boot 3.4.x
- Jakarta Mail (Eclipse Angus) for IMAP / SMTP
- FileMaker via JDBC with a custom Hibernate dialect
- Spring Security, Spring Data JPA
Requirements #
- FileMaker Server with JDBC access
- Java 17~21 runtime
- Network access to IMAP and SMTP servers
- ~512 MB RAM minimum (1 GB+ recommended)
Deployment #
Distributed as an executable Spring Boot JAR with external config/application.properties. A macOS launchd deployment (plist) is included for background service operation.