Email Polling (IMAP)

Envoi can automatically receive invoices from a connected email inbox. When enabled, it monitors your inbox for emails that look like invoices and imports the attached PDFs as received invoices.

You can connect your inbox in two ways: Gmail OAuth (one click, no passwords) or manual IMAP (any provider).

Option 1 — Connect with Gmail (OAuth)

If you use Gmail, this is the easiest path:

1. Go to Settings → Configuration
2. Click Connect Gmail
3. Authorize Envoi via the standard Google sign-in flow
4. Done — Envoi now polls your Gmail inbox

You don't enter any passwords or app passwords, and you can revoke access at any time from your Google account permissions.

Option 2 — Connect via IMAP (any provider)

For Outlook, Domene.no, Fastmail, or any other email provider:

1. Go to Settings → Configuration
2. Under IMAP settings, enter your email connection details:
   • IMAP Server — your email provider's IMAP hostname
   • Port — typically 993 for SSL
   • Email address — the inbox to monitor
   • Password — your email password or app-specific password

Common IMAP Settings

Provider	IMAP Server	Port
Gmail	imap.gmail.com	993
Outlook / Hotmail	outlook.office365.com	993
Domene.no	imap.domene.no	993

For Gmail, prefer Option 1 (Gmail OAuth) above. If you stick with manual IMAP, you'll need an App Password instead of your regular password — generate one in your Google Account security settings.

Testing the Connection

After entering your IMAP settings, click Test Connection to verify that Envoi can reach your inbox. A success or error message will appear.

How It Works

• Once connected, Envoi polls your inbox every 10 minutes
• It looks for emails that contain invoice-related keywords and have a PDF attachment
• Matching invoices are imported automatically and appear in your Received Invoices list with a Pending status
• You can then use Extract & Review to let Saga (Envoi's AI) read the invoice, just like manually uploaded invoices

Manual Poll ("Poll Now")

If you're expecting an invoice and don't want to wait for the next 10-minute cycle, click Poll Now in the IMAP settings. Envoi will immediately scan the inbox and import any matching emails. The button times out after 90 seconds and is available to Owners and Admins only.

Enabling and Disabling

Use the toggle on the Configuration page to enable or disable email polling at any time. When disabled, Envoi stops checking the inbox but your settings are preserved — re-enable any time without re-entering credentials.