> ## Documentation Index
> Fetch the complete documentation index at: https://docs.twenty.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Mailbox

> Understanding email integration features in Twenty.

**Note**: To connect your email accounts and configure sync settings, visit [Email & Calendar Setup](/user-guide/calendar-emails/overview).

## How Email Integration Works

Twenty automatically links emails from your connected mailboxes to the relevant CRM records, keeping all communication history in one place.

### Objects Where Emails Can Be Found

Email conversations appear in three main objects:

* **People**: View all emails exchanged with a specific contact
* **Companies**: See all emails related to a company and its employees
* **Opportunities**: Access email threads related to the company linked to this opportunity. Email threads from individual people on the opportunity are not shown yet.

### Viewing Email Threads

1. **Navigate to a Record**: Go to any Person, Company, or Opportunity record
2. **Select the Emails Tab**: Click on the `Emails` tab to view synced emails
3. **Open an Email Thread**: Click on any email to open and read the full conversation
4. **Browse History**: Scroll through the complete email history with that contact

<img src="https://mintcdn.com/twenty/JIRRbviz5phT8G2L/images/user-guide/emails/show-inbox.png?fit=max&auto=format&n=JIRRbviz5phT8G2L&q=85&s=30ebe1eeddba9539a4449358b86bc28f" style={{width:'100%'}} width="1600" height="1000" data-path="images/user-guide/emails/show-inbox.png" />

## What You'll See

### Email Thread View

When you open an email thread, you can:

* **Read Full Conversations**: See the complete email exchange
* **View Participants**: See all people involved in the email thread
* **Check Timestamps**: Know exactly when each email was sent
* **Access Context**: Understand the full communication history

### Email Visibility

Depending on your mailbox settings, you might see:

* **Full Content**: Complete email text and details
* **Subject + Metadata**: Subject line, sender, recipient, and timestamp
* **Metadata Only**: Basic information without email content

## Email Sync Behavior

### Sync Rate

Twenty imports emails at approximately **400 messages per minute**. This rate is currently limited by Gmail API rate limiting (and applies similarly to other providers).

For reference:

* 1,000 emails → \~2.5 minutes
* 10,000 emails → \~25 minutes
* 50,000 emails → \~2 hours

### What Gets Synced

* **External Emails**: All emails with contacts outside your organization
* **Automatic Linking**: Emails connect to existing People and Company records
* **Multiple Addresses**: Emails from any address link to the same contact record
* **Updates**: New emails appear within 5 minutes

### What Doesn't Get Synced

* **Internal Emails**: Emails between colleagues (same domain) remain private
* **Group Emails**: Distribution lists and group emails are excluded
* **Excluded Folders**: Folders you've chosen not to sync (configured under Settings → Accounts → Email)

### Selective Folder Sync

Control which email folders sync with Twenty:

1. Go to **Settings → Accounts** and select your connected email account
2. Configure folders under the Email section
3. Choose specific folders to include or exclude (Inbox, Sent, Archive, custom folders)

## Troubleshooting Email Sync

### Common Sync Issues

* **Sync Delays**: Emails appear within 5 minutes, but initial imports take longer
* **Missing Emails**: Check if:
  * Folders are excluded in Message Folder settings
  * Contact auto-creation is disabled (emails need existing Twenty records)
  * Email is from colleagues (same domain) or group lists
  * Mailbox is still completing initial sync

### Email Limitations

* **System Folders**: Some email folders may not be available for sync
* **Aliases**: Only true mailboxes can be connected (not email aliases)
