docs: update calendar-email page (#21719)

Adds 3 changes
1.) Add IMAP mention
2.) Clarifies disabling SSRF for self hosters running air gapped
systems, (we have received this question several times ) 3.) Toggling
Syncing internal emails

<!-- This is an auto-generated description by cubic. -->
<a
href="https://cubic.dev/pr/twentyhq/twenty/pull/21719?utm_source=github"
target="_blank" rel="noopener noreferrer"
data-no-image-dialog="true"><picture><source
media="(prefers-color-scheme: dark)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"><source
media="(prefers-color-scheme: light)"
srcset="https://www.cubic.dev/buttons/review-in-cubic-light.svg"><img
alt="Review in cubic"
src="https://www.cubic.dev/buttons/review-in-cubic-dark.svg"></picture></a>
<!-- End of auto-generated description by cubic. -->
This commit is contained in:
neo773
2026-06-17 18:37:04 +05:30
committed by GitHub
parent 1f9c4cf5b9
commit 91050dba8d
@@ -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
<Note>
**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.
</Note>
### 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
<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>
<Note>
**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).
</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
@@ -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.