Email connections
Connect Gmail, Outlook, IMAP or email forwarding: Getbeel finds supplier invoices in your mailbox.
Getbeel reads the mailboxes you connect and imports the emails with invoices. You can connect several mailboxes per team, for example admin@ and invoices@.
Before you start
- A plan with invoice credits. Without a plan, the connect buttons are disabled.
- Your plan's limit. Settings → Email shows how many email connections you use out of the total.
- You don't need to give Getbeel your Gmail or Outlook password: access goes through Google or Microsoft, read-only.
- Cost. Each invoice read uses one credit; email forwarding is a paid add-on (Pricing).
Connect a mailbox
Open the email settings
Open Settings → Email. The tabs are Gmail, Outlook, Other email and Email forwarding.
Choose your provider and authorize
- Gmail: press Connect Gmail and allow email reading on Google's screen.
- Outlook: press Connect Outlook and sign in with your Microsoft account (Outlook.com or Microsoft 365).
- Other email (IMAP): press Connect IMAP. Choose the Email provider, then enter your address and an app password.
For IMAP, Getbeel uses SSL/TLS on port 993. Servers that offer only other ports or STARTTLS are not supported.
Look for past invoices
Open Received invoices and press Scan now. Choose a period, for example Last 3 months, and press Start scan.
What just happened
- The mailbox is connected. After the first successful sign-in, its status is Email access verified.
- Getbeel checks it once a day and imports new invoices on its own.
- The scan of the period has started. Received invoices shows the progress and updates on its own.
- The AI reads each invoice found and puts it in Received invoices.
Forward invoices
Forwarding helps when you don't want to connect the whole mailbox. It is a paid add-on.
- Open Settings → Email → Email Forwarding and press Set up forwarding.
- Copy the Forwarding address.
- Forward invoices to that address, by hand or with a rule in your email app.
Getbeel processes each email as soon as it arrives.
Manage your connections
Each mailbox shows its address and status. From the row's menu:
- Reconnect (Gmail): renews the authorization if Google revoked it.
- Disconnect: Getbeel stops reading the mailbox. Invoices already imported stay.
Scan history, on the same page, lists every scan with its type, status, and the invoices found and processed. Open a row to see the outcome of each email:
| Outcome | What it means |
|---|---|
| Invoice created | The invoice is in Received invoices |
| Needs invoice document | The email mentions an invoice but has no readable attachment |
| Duplicate | The invoice is already there |
| Not an invoice | For example a newsletter |
| No invoice content | The email or attachment has no readable text |
| No credits | Skipped: your invoice credits have run out |
| Error | An unexpected error; Getbeel retries on its own |
If it fails
| Message | Cause | Fix |
|---|---|---|
| Reconnect required: "GetBeel cannot read this mailbox. …" | Google revoked access | From the mailbox's menu choose Reconnect |
| "Choose the same Google account as the mailbox you are reconnecting." | You chose a different account | Reconnect with the right account |
| "Your Google Workspace administrator blocked Gmail access. …" | Your domain blocks outside apps | Ask your administrator to allow Getbeel, or upload the files |
| "Your email connection limit has been reached." | Your plan allows fewer mailboxes | Disconnect a mailbox or change plan |
| "Email Routing is a paid add-on. …" | The forwarding add-on is missing | Press Go to Usage & billing |
| Scans need attention | Imports keep failing | Getbeel retries on its own; if it continues, reconnect the mailbox |
After reconnecting, press Scan now for the missing period.