diff --git a/packages/twenty-docs/user-guide/calendar-emails/overview.mdx b/packages/twenty-docs/user-guide/calendar-emails/overview.mdx index 203c5d9763..b348118068 100644 --- a/packages/twenty-docs/user-guide/calendar-emails/overview.mdx +++ b/packages/twenty-docs/user-guide/calendar-emails/overview.mdx @@ -23,13 +23,23 @@ description: Connect your email and calendar accounts to Twenty. 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) +### IMAP/SMTP/CalDAV Setup (Other Providers) For other email and calendar providers: 1. Go to **Settings → Accounts** -2. Configure SMTP settings for email +2. Configure IMAP settings to sync incoming email and SMTP settings to send email 3. Configure CalDAV settings for calendar 4. Test the connection + +**Self-hosting on an air-gapped or internal network**: By default, Twenty refuses outbound connections to private/internal IP addresses (SSRF protection). If your mail or calendar server runs on a local/private IP (e.g. an on-premise server on a LAN), connections to it will be blocked. To allow them, set the following environment variable on the server: + +``` +OUTBOUND_HTTP_SAFE_MODE_ENABLED=false +``` + +This disables safe mode for **all** outbound requests (HTTP workflow actions, webhooks, and IMAP/SMTP/CalDAV connections), so only set it on trusted, isolated networks where the SSRF protection is not needed. + + ### Multiple Mailboxes - **Unlimited Accounts**: Connect multiple email accounts per user - **Account Management**: Switch between different mailboxes @@ -54,10 +64,19 @@ Choose different levels of visibility for your emails: - **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**: By default, internal emails (where all participants share your domain) are not synced to protect privacy 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. + +**Syncing internal emails**: The "internal emails not synced" behavior is the default, but it can be turned off. The toggle lives in advanced settings: +1. Open **Settings** and enable the **Advanced** toggle at the bottom of the settings page +2. Go to **General → Security** +3. Enable the **Sync Internal Emails** toggle to include emails where all participants share the same domain + +This is a workspace-wide setting (useful for universities or shared-domain organizations). + + ### 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 @@ -71,7 +90,7 @@ This gives you precise control over which emails appear in your CRM without sync **What Gets Synced:** - **External Emails**: All emails with external contacts from selected folders -- **Internal Emails**: Not synced (same domain emails remain private) +- **Internal Emails**: Not synced by default (same domain emails remain private). Enable the **Advanced** toggle at the bottom of **Settings**, then turn on **Sync Internal Emails** under **General → Security** to include them workspace-wide. - **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.