Troubleshooting Add Email Errors in Salesforce for Outlook (SFO) Side Panel

Key Terms:

• SFO (Salesforce for Outlook) — A retired legacy Salesforce integration for Microsoft Outlook desktop.
• FLS (Field Level Security) — A Salesforce permission setting that controls which fields are visible or editable for each user profile. Misconfigured FLS is a common cause of SFO errors.
• Side Panel — The Salesforce panel displayed within Microsoft Outlook that allows users to view and interact with Salesforce records.

Scenario 1 — "Error in getting contacts" / Envelope Icon Does Not Turn Green

Users are unable to add an email from the Side Panel. The envelope icon appears to process but never turns green and the following error appears in red:
Error in getting contacts: SidePanelException — No Matching Contacts or Leads
Root Cause: The Name, Comment, and Due Date fields on the Task object are not visible to the affected user's profile. FLS (Field Level Security) for these fields is set to Hidden.
Resolution: Update the user's profile FLS settings to make the Name, Comment, and Due Date fields on the Task object visible. See: Unable to Add Email using Salesforce for Outlook Side Panel - Error in getting contacts

Scenario 2 — "We couldn't add this item. Please try adding this item again"

An error message appears after clicking the envelope icon next to a record in the Side Panel.
Root Cause: One or more of the following may be causing the error:

• A Validation Rule on the Task object
• A Workflow Rule
• An Apex Trigger
• Email body content is too large for the Description field

Resolution: Disable Validation Rules, Workflow Rules, and Apex Triggers one at a time to isolate the cause. See:  Salesforce for Outlook Side Panel error when trying to add an email 'We couldn't add this item. Please try adding this item again.'

Scenario 3 — Add Email Envelope Icon is Missing

The small envelope icon is not visible in the Side Panel.
Root Cause: The Add Email option is not enabled for the organization.
Resolution: The Add Email icon is missing from the SFO Side Panel

Scenario 4 — Attachment Fails After Email is Added

The email adds successfully, but selecting an attachment fails with: "We couldn't add this item. Please try adding this item again."
Root Cause: The session is locked to a specific IP address. The SFO log file contains the error: INVALID_SESSION_ID. This occurs because the Lock sessions to the IP address from which they originated setting is enabled in the org.
Resolution: Disable the "Lock sessions to the IP address from which they originated" setting in the org's Session Settings. See: Salesforce for Outlook: Emails are added but adding attachment fails - “We couldn't add this item. Please try adding this item again"

Scenario 5 — Emails Added to Salesforce Disappear from Outlook

After adding an email to Salesforce, the email appears to disappear from the Outlook inbox.
Root Cause: When an email is added to Salesforce via SFO, Outlook changes the email's category. Depending on the current Outlook view settings, categorized emails may be sorted to a different position or folder, making them appear to disappear.
Resolution: Change the Outlook view to show all emails regardless of category. See: Salesforce for Outlook - Emails added to Salesforce disappear from Outlook