ContextQMD
Back to Twenty

Calendar & Emails

packages/twenty-docs/user-guide/calendar-emails/overview.mdx

2.2.04.9 KB
Original Source

Connection Options

Google Account (Gmail & Google Calendar)

  1. Go to Settings → Accounts
  2. Click Add account
  3. Select Continue with Google
  4. Authorize Twenty to access your Gmail and Google Calendar
  5. Configure email sync settings (visibility, auto-creation) → click Next
  6. Configure calendar sync settings (visibility, auto-creation) → click Add Account
  7. Your emails and calendar events will start syncing automatically

Microsoft Account (Outlook & Microsoft Calendar)

  1. Go to Settings → Accounts
  2. Click Add account
  3. Select Continue with Microsoft
  4. Authorize Twenty to access your Outlook and Microsoft Calendar
  5. Configure email sync settings (visibility, auto-creation) → click Next
  6. Configure calendar sync settings (visibility, auto-creation) → click Add Account
  7. Your emails and calendar events will start syncing automatically

SMTP/CalDAV Setup (Other Providers)

For other email and calendar providers:

  1. Go to Settings → Accounts
  2. Configure SMTP settings for email
  3. Configure CalDAV settings for calendar
  4. Test the connection

Multiple Mailboxes

  • Unlimited Accounts: Connect multiple email accounts per user
  • Account Management: Switch between different mailboxes
  • Sync Settings: Configure different settings per mailbox
<Warning> Only true mailboxes can be connected (e.g., [email protected] with its own inbox). Email aliases that forward to another mailbox cannot be connected to Twenty. </Warning>

Email Configuration

Message Visibility

Choose different levels of visibility for your emails:

  • Metadata Only: Share only basic information (sender, recipient, date, time)
  • Subject and Metadata: Share subject line along with metadata
  • All Email Content: Share entire email content including attachments

Contact Auto-Creation

  • Deactivated: No automatic contact creation
  • For messages sent & received: Create contacts for all external email interactions
  • For messages sent only: Create contacts only for emails you send
  • Note: Internal emails (same domain) are never synced to maintain privacy

<Note>When enabled, contacts are automatically linked to their Company records based on their email domain. If the company doesn't exist yet, Twenty creates it for you.</Note>

Control which emails get synced with Message Folder Selection

Control which email folders sync with Twenty:

  1. Go to Settings → Accounts and select your connected email account
  2. Choose which folders to sync:
    • Inbox: Primary incoming emails
    • Sent: Outgoing emails you've sent
    • Custom Folders: Any specific folders you want to include
    • Exclude Folders: Skip folders like Spam, Trash, or personal folders

This gives you precise control over which emails appear in your CRM without syncing everything.

What Gets Synced:

  • External Emails: All emails with external contacts from selected folders
  • Internal Emails: Not synced (same domain emails remain private)
  • Attachments: Coming in H1 2026

Note: We don't provide a CC email address for selective syncing. Instead, use the Message Folder feature above to achieve the same level of control over which emails sync with Twenty.

Calendar Configuration

Event Visibility

Choose what will be visible to other users in your workspace:

  • Everything: The whole event details will be shared with your team
  • Metadata: Only date & participants will be shared with your team

Contact Auto-Creation for Meetings

  • Yes: Automatically create contacts for meeting participants not in your CRM
  • No: Only link meetings to existing contacts

<Note>When enabled, contacts are automatically linked to their Company records based on their email domain. If the company doesn't exist yet, Twenty creates it for you.</Note>

Control which events get sync

  • Meeting Import: Automatically import calendar events
  • Contact Linking: Link meetings to People and Company records

What Gets Synced:

  • Meetings: Calendar events with external participants
  • Contact Linking: Events automatically linked to CRM records
  • Team Events: Shared calendar visibility

Sync Frequency

Updates every 5 minutes: Both email and calendar data sync automatically every 5 minutes after the initial import.

<Note> **Initial sync timing**: Calendar sync completes quickly (usually within minutes), while email sync takes longer for large mailboxes. Twenty imports emails at approximately **400 messages per minute** (limited by Gmail API rate limiting), so a mailbox with 10,000 emails takes about 25 minutes. Don't worry if you see contacts from calendar events appearing before your email contacts; this is normal behavior. </Note>

Next Steps