# Email connections (https://docs.getbeel.com/en/guide/invoice-management/gmail-integration)

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 [#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](/en/api/pricing)).

## Connect a mailbox [#connect-a-mailbox]

<Steps>
<Step>

### Open the email settings [#open-the-email-settings]

Open **Settings → Email**. The tabs are **Gmail**, **Outlook**, **Other email** and **Email forwarding**.

</Step>
<Step>

### Choose your provider and authorize [#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.

</Step>
<Step>

### Look for past invoices [#look-for-past-invoices]

Open **Received invoices** and press **Scan now**. Choose a period, for example **Last 3 months**, and press **Start scan**.

</Step>
</Steps>

## What just happened [#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 [#forward-invoices]

Forwarding helps when you don't want to connect the whole mailbox. It is a paid add-on.

1. Open **Settings → Email → Email Forwarding** and press **Set up forwarding**.
2. Copy the **Forwarding address**.
3. 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 [#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 [#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.

## Next steps [#next-steps]

<Cards>
  <Card title="AI extraction" href="/en/guide/invoice-management/ai-extraction">
    What the AI reads from each invoice.
  </Card>
  <Card title="AI rules" href="/en/guide/invoice-management/categories-rules">
    Exclude senders or correct data automatically.
  </Card>
  <Card title="Codice destinatario" href="/en/guide/codice-destinatario">
    Receive e-invoices from SDI as well.
  </Card>
</Cards>
