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:
@@ -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.
|
||||
|
||||
Reference in New Issue
Block a user