---
title: "Email inboxes"
url: "/help/buuk/email-inboxes"
updated: "2026-10-25T16:58:19.085Z"
---
# Email inboxes

Plenty of teams run support out of a shared inbox rather than a desk. Connect **Gmail** or **Outlook** and support emails become the same draft material the desk connectors produce.

## Gmail

Connect with Google OAuth and Buuk reads messages from the last `90` days — subject plus plain-text body, up to 8,000 characters each. Narrow the import with an optional inbox filter, a search query such as `label:support`; leave it blank and recent mail is the source. When the platform Google app is not configured on your deployment, paste an access token instead.

### Step by step

1. **Connect from the card**
   Open **Integrations** and pick **Gmail**, then press **Connect**.

2. **Choose the inbox account on Google’s screen**
   Google shows a “Choose an account” page listing browser sessions. Pick the mailbox that truly receives support mail — a shared inbox is better than a personal one. Gmail Workspace users can add a shared address for a colleague from Google Admin if needed.

3. **Handle Google’s app-verification warning**
   If the connector app is still marked Testing or unverified — mostly on custom or self-hosted deployments — Google shows “Google hasn’t verified this app”. Press **Advanced → Go to <App name> (unsafe)** only when the host is one you trust; otherwise ask your Buuk admin to finish verification or add the account as a test user.
   
   Inside a Google Workspace organization the sign-in may stop with “This app is blocked”. A Workspace super-admin has to allow the app under **Admin console → Security → API controls**.

4. **Review the requested access**
   The consent screen asks for read-only access to Gmail messages and settings plus your profile. Press **Allow**. Buuk never sends mail from the inbox.

5. **Optionally narrow the import**
   From **Manage** on the card, set an inbox filter such as `label:support`. Create the label in Gmail first (**Labels sidebar → Create new label**), then label the threads that count as support; leave the filter blank to import all recent mail.

## Outlook

Connect through Azure OAuth with read access to your mailbox, or paste an access token. An optional **Mail folder** limits the import to one folder; leave it blank and your whole mailbox is the source.

### Step by step

1. **Connect and pick the work account**
   Press Connect on the Outlook card and choose the work or school account that receives support mail. Personal Microsoft accounts can also connect, but shared-team inboxes usually live on a tenant account.

2. **Grant the read permission**
   The consent screen lists read access to your mailbox and basic profile. Press **Accept**. Locked-down tenants may require an admin to approve — the screen says so and offers a request path; forward it to your admin.

3. **Optionally limit the folder**
   From **Manage** on the card, set the Mail folder name exactly as Outlook shows it (`Inbox`, `Archive`, or a shared or custom folder). Buuk reads the name literally, so a typo yields an import of nothing.

## What emails become

Imported threads land in the same pipeline as tickets: drafts for real gaps, and the theme scan over the last `30` days turns repeated subjects into [suggested updates](./suggested-updates). An alias that gets the same question weekly is usually the fastest article you will ever write.

> [!NOTE]
> For programmatic routing, an inbound email endpoint can also file suggestions directly, deduplicated per message — that is how forwarding rules and automations push mail in.

## Troubleshooting

**The OAuth screen blocks me**

While the Google app is in Testing mode, only registered test users can connect. Add your account as a test user on the consent screen, or publish the app.

**Mail imports from the wrong folder**

Check the folder name under **Manage** on the Outlook card — Buuk reads the folder name exactly as it exists on the server.

## Related

- Desk-based sources: [More support desks](./support-desks).
- Chat-based sources: [Community and social channels](./community-channels).
- Where email drafts land: [Suggested updates](./suggested-updates).
- The full catalog: [Integrations overview](./connect-integrations).