# How to Configure Incoming and Outgoing Email

**Overview**

Configuring your email channels enables BoolDesk to automatically convert incoming emails into tickets and send outgoing notifications to users. You can configure these settings using standard SMTP/IMAP protocols or, for Microsoft 365 users, the more secure Microsoft Graph API.

#### **Step-by-Step Guide**

**1. Navigate to Email Settings**

Start by accessing the email management section.

* From the main menu, go to Settings (1).
* Under the `General` section, click on Email (2).
* Click the Add Email button (3) to create a new channel.

<figure><img src="https://1656339521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuVnkK2LsQssipBV5XZc%2Fuploads%2Few7IWt9pEg37IsG2yWoo%2Fimage.png?alt=media&#x26;token=0d78010b-0f9d-4968-b9e2-6beb550e83ef" alt=""><figcaption></figcaption></figure>

**2. Configure General Settings**

In the "General" tab, define how the email account will appear to users.

* Display Name: Enter the name users will see when they receive an email (e.g., `BoolDesk Email`).
* Email Address: Enter the primary email address for this channel (e.g., `booldesktest@booldesk.com`).
* Default Mail: Toggle this on if you want this address to be used for all system notifications by default.

<figure><img src="https://1656339521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuVnkK2LsQssipBV5XZc%2Fuploads%2FIFxgd1W53HbhDrYNNNtu%2Fimage.png?alt=media&#x26;token=759cc112-ac34-4564-a2f8-cd62661de50a" alt=""><figcaption></figcaption></figure>

**3. Configure Incoming Email (Microsoft Graph API)**

Switch to the Incoming Email tab (1) to set up ticket creation from emails.

* Auth Type: Select Microsoft Graph API from the dropdown menu.
* Email: Re-enter the email address to be monitored.
* Client App Id & Tenant Id: Paste the Application (client) ID and Directory (tenant) ID that you copied from the Azure Portal during the app registration process.
* Test Connection: Click this button to verify the credentials.
* Enabled: Ensure the toggle is turned on to start fetching emails.

{% hint style="info" %}
You need to register BoolDesk as an application on your Azure Entra ID. <https://docs.booldesk.com/booldesk-settings/infrastructure-settings/how-to-configure-microsoft-entra-id-azure-ad-for-booldesk>
{% endhint %}

<figure><img src="https://1656339521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuVnkK2LsQssipBV5XZc%2Fuploads%2FzKmkh9z2mWJmFBp5sPHW%2Fimage.png?alt=media&#x26;token=983bfbf8-5a8f-41d1-9905-b66e166c0cd6" alt=""><figcaption></figcaption></figure>

**4. Configure Outgoing Email (SMTP)**

Switch to the Outgoing Email tab (1) to enable sending notifications.

* Auth Type: Select SMTP (or Microsoft Graph API if preferred).
* Email: Enter the sender address.
* Password (Secret Key): Enter the password for the email account.
* Server & Port: Enter your mail server details. For Outlook/Microsoft 365, use `smtp-mail.outlook.com` and port `587`.
* Test Connection: Click to verify that BoolDesk can send emails.
* Click Save to finalize your email channel configuration.

<figure><img src="https://1656339521-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FbuVnkK2LsQssipBV5XZc%2Fuploads%2FdlhfKNKDcL2gGn7vC7ON%2Fimage.png?alt=media&#x26;token=1f78ca2a-2b53-4127-94a2-933710f89e15" alt=""><figcaption></figcaption></figure>
