> For the complete documentation index, see [llms.txt](https://docs.sangamcrm.com/sangam-crm/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.sangamcrm.com/sangam-crm/outgoing-email-setup.md).

# Outgoing Email Setup

## **Introduction**

This guide covers the steps required to configure outbound email functionality in your CRM using **GMail**, **Office 365 (Microsoft Exchange)**, and **SendGrid**. With this setup, users can send emails directly from the CRM for efficient communication with customers, prospects, and team members.

***

## **1. Prerequisites**

Before starting the setup, ensure you have:

* CRM admin access.
* Access to your GMail, Microsoft Exchange, or SendGrid account.
* SMTP details, App Passwords, or API keys as required.

***

## **2. Configuring GMail in CRM**

### **Step-by-Step Instructions**

<figure><img src="/files/6nvSjY4ite2lSODHvVmr" alt=""><figcaption></figcaption></figure>

1. **Go to Email Settings in CRM**:
   * Navigate to **Admin** > **Channels** > **Email**.
2. **Enter Gmail SMTP Details**:
   * **Email Provider**: Select **SMTP**.
   * **SMTP Mail Server**: Enter `smtp.gmail.com`.
   * **Port**: Use `587` (TLS).
   * **From Email**: Enter your Gmail address.
   * **SMTP Password**: Generate and use a Gmail **App Password** (steps below).

### **How to Generate GMail App Password**

1. **Enable 2-Step Verification**:

<figure><img src="/files/ll7ZYNwJgqXkrRTZNSG7" alt="" width="375"><figcaption></figcaption></figure>

<figure><img src="/files/lQAEzVjZknZb8pmbt453" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/CCDtX2wWoIeejf66ZonR" alt=""><figcaption></figcaption></figure>

* Log in to your Google account.
* Go to **Security** and enable **2-Step Verification**.

1. **Generate App Password**:

<figure><img src="/files/XfowakKb6NwrGRq8r2Md" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/KBx9C21DPYuo5DUMdHvo" alt="" width="563"><figcaption></figcaption></figure>

<figure><img src="/files/yG1FbHcBigIhuxeOdIRg" alt="" width="563"><figcaption></figcaption></figure>

* After enabling 2-Step Verification, go to **App Passwords** under **Security**.
* Choose **Mail** for the app, and select **Other** for the device (name it “CRM”).
* Copy the generated App Password and use it in the **CRM Password field**.

1. **Test the Configuration**:
   * Use the **Send Test Mail** option to verify the setup.

***

## **3. Configuring Office 365 Email in CRM**

### **Step-by-Step Instructions**

<figure><img src="/files/K3FfGNIvMGj0uHDy475Y" alt=""><figcaption></figcaption></figure>

1. **Go to Email Settings in CRM**:
   * Navigate to **Admin** > **Channels** > **Email**.
2. **Enter Office 365 Details**:
   * **Email Provider**: Select **SMTP**.
   * **SMTP Mail Server**: Enter `smtp.office365.com`
   * **Port**: Use `587` (TLS).
   * **From Email**: Enter your Office 365 email address.
   * **SMTP Password**: If Multi-Factor Authentication (MFA) is enabled, generate an **App Password** (explained below).
3. **Generate Office 365 App Password** (If MFA is enabled):

   To generate an App Password if MFA is enabled, follow these steps:

   1. **Log in to your** [**Office 365 account**.](https://admin.microsoft.com/)
   2. **Go to the Microsoft 365 Admin Center**: <br>

      <figure><img src="/files/hL95aOh86tAi5FBJt6cW" alt=""><figcaption></figcaption></figure>
   3. Navigate to **Users** > **Active Users**.<br>

      <figure><img src="/files/ZXLqXSUI5pFnl499Ywpy" alt=""><figcaption></figcaption></figure>
   4. **Select the User**:<br>

      * In the flyout that appears, select **Mail**.

      <figure><img src="/files/JouMum6ck3wgXd2TZe3K" alt=""><figcaption></figcaption></figure>
   5. **Manage Email Apps**:
      * Under the **Email Apps** section, select **Manage Email Apps**.
   6. **Verify the Authenticated SMTP setting**:<br>

      * **Unchecked = Disabled**.
      * **Checked = Enabled**.

      <figure><img src="/files/rjNunSnVBd0f0UOMRcL0" alt=""><figcaption></figcaption></figure>
   7. **Save changes**.
4. **Test the Configuration**:
   * Use the **Send Test Mail** option to ensure everything is working correctly **If You Cannot See the Option to Generate an App Password**

#### If you don't see the option to generate an [App Password](https://account.activedirectory.windowsazure.com/UserManagement/MfaSettings.aspx), follow these steps

1. **Admin Login**:
   * Log in to the **Microsoft 365 Admin Center**.

2. **Navigate to**:
   * **Users** > **Active Users**.

3. **Select the User** you need to configure.

4. **Go to Multi-Factor Authentication Settings**:
   * Set **Multi-Factor Auth Status** to **Enforce**.

5. **Logout the User**:
   * Ensure the user logs out of all active sessions.

6. **Wait for the Changes to Propagate**:
   * After enforcing MFA, it may take **3 to 4 hours** for the changes to fully propagate and update the user’s roles and permissions. Wait for at least **4 hours** before retrying to generate an App Password.

7. **Generate a New App Password**:
   * After the waiting period, go back to the Microsoft account **security settings** and attempt to generate the **App Password** again.

8. **Copy the App Password**:
   * Once generated, copy the App Password.

9. **Paste the App Password**:

   * Paste the App Password into the **SMTP Password** field in your CRM settings.

10. If you still fail to send the email  check the **Conditional Access** policy and exclude the user from the policy. For guidance, please review the document.\
    <https://learn.microsoft.com/en-us/answers/questions/512954/535-5-7-139-authentication-unsuccessful>

## **4. Configuring SendGrid for CRM**

SendGrid is primarily used for sending bulk marketing emails. Here’s how to integrate SendGrid with your CRM.

### **Step-by-Step Instructions**

1. **Go to Email Settings in CRM**:
   * Navigate to **Admin** > **Channels** > **Email**.
2. **Enter SendGrid API Details**:
   * **Email Provider**: Select **SendGrid**.
   * **From Name**: Enter your preferred sender name (e.g., “CRM”).
   * **API Key**: Enter the **API Key** generated in SendGrid (steps below).
3. **Generate SendGrid API Key**:
   * Log in to your SendGrid account.
   * Go to **Settings** > **API Keys**.
   * Create a new API key, name it, and provide **Full Access**.
   * Copy the API key and paste it into the CRM.
4. **Test the Configuration**:
   * Use the **Send Test Mail** option to ensure the setup works properly.

***

## **5. Troubleshooting Common Issues**

### **Problem: Gmail App Password Not Working**

* **Cause**: Users may be entering their regular Gmail password instead of the App Password.
* **Solution**: Verify that **2-Step Verification** is enabled and an App Password has been generated for the CRM.

### **Problem: Office 365 Fails to Send Emails**

* **Cause**: This can occur if Multi-Factor Authentication (MFA) is enabled but an App Password is not used.
* **Solution**: Generate an **App Password** under **Security & Privacy** in Office 365 and use that in the CRM configuration.

### **Problem: SendGrid Emails Not Sending**

* **Cause**: Incorrect API key configuration or invalid domain settings.
* **Solution**: Verify the API key in SendGrid and ensure that the CRM’s IP addresses are whitelisted in SendGrid.

***

## **6. Best Practices for Email Configuration**

* **Keep App Passwords and API Keys Secure**: Store these credentials in a secure location and avoid sharing them unnecessarily.
* **Test Email Settings Regularly**: Periodically use the **Send Test Mail** feature to ensure configurations remain valid.
* **Monitor Mail Flow Rules in Exchange**: Regularly review and update mail flow rules to adapt to changing email routing needs.