Email Mailboxes & Ingestion

With DocsToSheets, you don’t need to manually upload documents every time. You can set up custom email mailboxes that automatically extract attachments from incoming emails, run AI parsing, and append the results to your spreadsheets.

---

Inbound Ingestion Pipeline

When an email arrives at your custom mailbox, it goes through the following automated steps:

graph TD
    A[Sender Emails Document] -->|To: [email protected]| B(DocsToSheets Gateway)
    B --> C{Is Sender Authorized?}
    C -->|No| D[Send Rejection Email]
    C -->|Yes| E[Extract Attachments]
    E --> F[AI Processing & Mapping]
    F --> G[Append Row to Spreadsheet]

1. Email Interception
   • Trigger: A sender emails a document to your custom address (e.g. [email protected]).
   • Action: The DocsToSheets email gateway receives the incoming email and extracts the message payload.
2. Authorized Sender Verification
   • Security: The system validates the mailbox details and checks if the sender’s address matches your Authorized Senders Allowlist.
   • Rejection: If unauthorized, the email is rejected, and an automated bounce notification is returned to the sender.
   • Extraction: If authorized, the system extracts up to 10 document attachments (PDFs, images) from the email payload.
3. AI Field Mapping
   • Action: DocsToSheets processes the documents, extracts key values, and maps them to your spreadsheet columns.
4. Spreadsheet Export
   • Result: The normalized data is appended as a new row to your linked Google Sheet or Excel Workbook in real-time.

---

Mailbox Address Format

Every mailbox you create has a unique address of the format:

[mailbox-slug]+[account-slug]@in.docmail.app

For example, if your mailbox name is billing and your account slug is acme-corp, your custom email address will be: [email protected]

---

Authorized Senders (Security Allowlist)

To protect your spreadsheets from spam and unauthorized entries, DocsToSheets enforces a strict Authorized Sender policy.

• Allowlist Enforcement: Only emails originating from addresses explicitly added to your mailbox’s allowlist will be processed.
• Rejection Notifications: If an unauthorized sender attempts to email your mailbox, the system rejects the email and sends an automated bounce-back notification explaining why the document was not processed.
• Managing Senders: You can add, edit, or remove authorized email addresses or wildcard domains (e.g. *@vendor.com) directly from the mailbox settings in the dashboard.

---

Processing Constraints

When sending files via email, keep the following limits in mind:

• Max Attachments: The system will process up to 10 attachments per email.
• Max Size: The total size of the email (including attachments) must not exceed 50MB.
• Supported Formats: The system extracts PDFs (application/pdf) and common images (JPEG, PNG). Text bodies or HTML formatting in the email are ignored; only file attachments are processed.

---

Active vs. Inactive Mailboxes

You can temporarily disable processing for any mailbox by toggling its status:

• Active: Accepting emails and processing files.
• Inactive: Bounces incoming emails with an “inactive mailbox” notification. No files will be processed.