Documentation

MailToSheet Ai Documentation

Welcome to the official documentation for MailToSheet Ai. Learn how to transform your inbox into a powerful database automation tool using advanced AI.

Introduction

MailToSheet Ai is an automated data extraction platform that parses incoming emails and attachments (PDFs, CSVs, Images) and syncs the structured data directly to Google Sheets or Airtable.

It eliminates manual data entry for workflows like invoice processing, real-estate lead capture, e-commerce order tracking, and more.

Getting Started

1. Create a Workflow

After signing up, click "New workflow" in your dashboard, or follow the Getting started checklist. Setup has three steps:

  1. Sample: upload a sample document (PDF, CSV, text, JSON or an image). Our AI finds the fields it contains, and you pick the ones you want as columns. A preview shows how the first row will look.
  2. Destination: choose where the rows go.
    • Google Sheets: share the sheet with our service email (shown during setup) as an Editor, then paste the sheet's link or ID and, optionally, the tab name. Your own account email must also own or be able to edit the sheet; we check this before writing to it.
    • Airtable: provide your Base ID, Table Name, and an Airtable personal access token with the data.records:read and data.records:write scopes. We store it encrypted.
    You can test the connection, and for Google Sheets insert a test row, before going live.
  3. Details: name the workflow and list its allowed senders.
Tip: analysing a sample uses credits, like a forwarded document does. Use a typical example of the emails you'll forward, so the fields match.

2. Setup Auto-Forwarding

Once created, you will get a unique email address like project.a1b2c3@sheet.mailtosheetai.com.

  1. Go to your email provider settings (Gmail, Outlook, etc.).
  2. Set up a forwarding rule based on criteria (e.g., "from: invoices@vendor.com" or "subject: New Lead").
  3. Forward these emails to your unique MailToSheet address.

Gmail: Gmail sends a confirmation code to the address before it will forward mail there. It appears in your workflow's Logs with a Confirm forwarding link.

Allowed senders: list either the original sender (e.g. your supplier) or the mailbox that forwards the email. We only process emails that verifiably come from a listed address.

3. Data Mapping

The fields you select from your sample document become your columns: in Google Sheets they are written to columns A, B, C… in the order you selected them; in Airtable each field goes to the field with the same name. You can change the column letters or Airtable field names later on the workflow's page.

When a document has several items (such as invoice lines), each item becomes its own row, with the document-level fields (invoice number, date, totals) repeated on every row.

Common Use Cases

Invoice Processing

Automatically capture invoice details from PDF attachments sent by suppliers.

Recommended Fields

  • invoice_number
  • date_issued
  • total_amount
  • vendor_name
  • due_date
  • currency

Lead Generation

Capture lead details from notification emails sent by platforms like Zillow, LinkedIn, or your own website contact form.

Recommended Fields

  • lead_name
  • email_address
  • phone_number
  • source_platform
  • message_body

Order Fulfillment

Log order confirmations from your store or marketplace. Each ordered item becomes its own row.

Recommended Fields

  • order_number
  • order_date
  • customer_name
  • product
  • quantity
  • shipping_address

Frequently Asked Questions

Is my data secure?

Emails are kept in our processing queue only until they have been processed, then deleted. The text and attachments are sent to OpenAI for extraction. Your activity log keeps the sender, subject and extracted data for 30 days, then deletes them automatically. See our Security page for details.

What happens if I exceed my plan limits?

Usage is measured in credits (AI tokens; a typical document uses about 1,500). When you run out, new emails are skipped: you'll see them in your Logs and get an email. Upgrade to continue right away. Free plans refill every month, and paid plans refill each time the subscription renews.

Does it work with attachments?

Yes. Every PDF, CSV, text, JSON and image (PNG, JPG, WebP, GIF) attachment is processed, up to 10 per email; logos embedded in signatures are ignored. PDFs need selectable text, so send scans as images. Excel files aren't supported yet (export them as CSV). Emails without attachments are read from the message body.

Still have questions?

Contact Support