# Credentials · Accounts · Email · Admin Portal

Connect a mailbox with its username, password and incoming and outgoing server settings. Check provider requirements, activate the account and retrieve messages.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/admin-portal-credentials
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a1452e-12e6-753b-9d84-e0fe592a2376"></a>

Credentials authentication uses the mailbox username and password, plus the incoming and outgoing mail server addresses, ports and security settings.

<a id="element-01a1452e-12e7-7825-8351-f71d4be8d491"></a>

## Connection requirements

Requirements for successful mailbox configuration:

<a id="element-01a1452e-12e9-7470-a6c7-e398c17777a5"></a>

- valid login credentials (email address and current password)
- the address of the outgoing mail server (SMTP), including the correct port and security mechanism (e.g., SSL/TLS, STARTTLS)
- the address of the incoming mail server (IMAP - recommended - or POP3), including the relevant port and security mechanism
- enabled message retrieval and sending services within the mailbox settings (IMAP/POP3, SMTP)
- awareness of whether Two-Factor Authentication (2FA) is enabled on the mailbox, as it may require an alternative login method (e.g., an application-specific password)
- if necessary, confirmation that access to the above ports and protocols is not restricted by the network or firewall

<a id="element-01a1452e-12e9-7210-8067-3103b7032ff4"></a>

The three tables below present the Credentials Authentication Support, SMTP server parameters, and IMAP server parameters for specific email providers.

<a id="element-01a1452e-12e9-7899-8d6c-1a8f6018295c"></a>

## Credentials support

Credentials Authentication Support

<a id="element-01a1452e-12ee-78ef-a4ca-0ee0e3da9fa4"></a>

| Mail Provider | Credentials Support | Notes |
| --- | --- | --- |
| Gmail | Limited | App password required and IMAP must be enabled. Standard account password does not work when 2FA is enabled. |
| Yahoo | Yes | App password required after enabling 2FA. |
| Microsoft Office 365 | Limited | Basic Auth over IMAP/SMTP may be disabled by the organization’s policy. Works only if Basic Auth is still enabled. |
| Microsoft Graph API | No | Only OAuth2 authentication is supported. IMAP/SMTP with user password is not available. |

<a id="element-01a1452e-12ee-7289-85b5-3b982da04663"></a>

## SMTP settings

SMTP Server Parameters (Credentials)

<a id="element-01a1452e-12f4-78e5-8c20-e3fa6a91a22b"></a>

| Mail Provider | SMTP Server | SMTP Port | SMTP Security |
| --- | --- | --- | --- |
| Gmail | `smtp.gmail.com` | `465` | SSL/TLS |
| Yahoo | `smtp.mail.yahoo.com` | `465` | SSL/TLS |
| Microsoft Office 365 | `smtp.office365.com` | `587` | STARTTLS |
| Microsoft Graph API | Not applicable | Not applicable | Not applicable |

<a id="element-01a1452e-12f4-714d-b0d7-0d9bcda368a1"></a>

## IMAP settings

IMAP Server Parameters (Credentials)

<a id="element-01a1452e-1304-759e-a358-cae201af5a2a"></a>

| Mail Provider | IMAP Server | IMAP Port | IMAP Security |
| --- | --- | --- | --- |
| Gmail | `imap.gmail.com` | `993` | SSL/TLS |
| Yahoo | `imap.mail.yahoo.com` | `993` | SSL/TLS |
| Microsoft Office 365 | `outlook.office365.com` | `993` | SSL/TLS |
| Microsoft Graph API | Not applicable | Not applicable | Not applicable |

<a id="element-01a1452e-1305-7361-88e6-2fd5cf5e14a3"></a>

## Account configuration

The screenshot below shows the fields required for **Credentials** authentication in Mint Service Desk.

<a id="element-01a1452e-1305-7b30-83e3-8cc4d281ce55"></a>

![The screenshot below shows the fields required for Credentials authentication in Mint Service Desk.](https://docs.mintsd.com/api/reader/assets/assets/images/image466.png?v=5ff052719a2e2bca7af50e1a1d861bc60432b505b04f199ea5577a6d9fe94eaa)

<a id="element-01a1452e-1307-7e01-9d28-4e1775a4884e"></a>

Complete the following fields:

<a id="element-01a1452e-1316-7109-872f-13c34df8985a"></a>

| Field | Description |
| --- | --- |
| **User name\*** | The login username for the mailbox. In most cases this is the full email address, unless the provider requires a different format. |
| **Password\*** | The mailbox account password associated with the User name. |
| **Send server address\*** | The SMTP server address used for sending outgoing emails. |
| **Send server port\*** | The port used for SMTP communication (typically 465 or 587 depending on the security method). |
| **Security (SMTP)** | The security protocol applied to the outgoing mail server connection (SSL/TLS or STARTTLS). |
| **Receive protocol\*** | The protocol for receiving email: IMAP (recommended) or POP3. |
| **Receive server address\*** | The mail server address for incoming email (IMAP or POP3 depending on the selected protocol). |
| **Receive server port\*** | The communication port for the incoming mail server (e.g., IMAP: 993, POP3: 995). |
| **Security (IMAP/POP3)** | Encryption type for incoming communication (typically SSL/TLS). |
| **Email address\*** | The mailbox address associated with this configuration. Must match credentials for most providers. |
| **Additional addresses** | Optional aliases or secondary addresses assigned to the same mailbox that should be handled in the system. |

<a id="element-01a1452e-1316-7e27-ad5e-a4eb98d32243"></a>

<a id="element-01a1452e-1317-7952-a75f-454b0fa3762a"></a>

After completing the fields, click ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image8.png?v=c6dfcae62b1da5a56376cb98f40e0a593d8d731e458977d27180f6380454b49d#element-01a1452e-1316-7e27-ad5e-a4eb98d32243) button to finish the process
and save the new email account.

<a id="element-01a1452e-1317-77fa-ab29-d5123716aec3"></a>

## Connection and activation

If the connection fails, an error appears when you try to save.

<a id="element-01a1452e-1318-7079-8264-d166c8c6a767"></a>

![Credentials: If the connection fails, an error appears when you try to save.](https://docs.mintsd.com/api/reader/assets/assets/images/image1352.png?v=c28a96102b4eabf5237006ac082f3b9f410ae83aea4be4d1ee4c3588e39df705)

<a id="element-01a1452e-1318-7b93-a590-f18e6ce63f18"></a>

After a successful save, the account appears on the Accounts list.

<a id="element-01a1452e-1319-718b-948f-902fdc829acd"></a>

<a id="element-01a1452e-1319-7cdf-a521-5250b92ad3c2"></a>

If any connection issues occur while using the mailbox (for example, if the password for the external mailbox connected to Mint has been changed), a warning icon ![Warning](https://docs.mintsd.com/api/reader/assets/assets/images/image468.JPG?v=57f638af485b7cb5fcd81ef3102b4be1740572919e306962e0e7314480645eef#element-01a1452e-1319-718b-948f-902fdc829acd) will appear in the Error occurred column.

<a id="element-01a1452e-1319-7c40-bacc-3f9b6196a6f8"></a>

![If any connection issues occur while using the mailbox (for example, if the password for the external mailbox connected to Mint has been changed), a warning icon button will appear in the Error occurred column.](https://docs.mintsd.com/api/reader/assets/assets/images/image469.png?v=a977dd9ec4037465ab825354b77626dc3dfcc2e69dc32a5ac13e5d87bf8ec878)

<a id="element-01a1452e-131a-7762-bca1-362060060240"></a>

<a id="element-01a1452e-131a-7ac6-b7da-cf9dd2f9917d"></a>

<a id="element-01a1452e-131b-7999-9224-76494dc4c332"></a>

To activate your new account, press the ![Activate](https://docs.mintsd.com/api/reader/assets/assets/images/image986.png?v=952f0336f0bac9bdf15873de79fa6c1abb420b22207837b079df1c1359b69936#element-01a1452e-131a-7762-bca1-362060060240) button. If for some
reason you want to deactivate it, you can easily do it, using ![Deactivate](https://docs.mintsd.com/api/reader/assets/assets/images/image987.png?v=19cde0099e0f2b55b801331ced64ec5e3a14e7b7e6975ac253618b361c27285b#element-01a1452e-131a-7ac6-b7da-cf9dd2f9917d) button.

<a id="element-01a1452e-131b-70f3-8670-634170bcb4bc"></a>

<a id="element-01a1452e-131b-73bd-be9a-2a0bf1ed0195"></a>

Once you have a working email account added to the system you can use
the ![Get](https://docs.mintsd.com/api/reader/assets/assets/images/image470.png?v=6eec84eba9d60dcfc3950906f5e572f951ece66a9176bb278b725ee8e2bffad9#element-01a1452e-131b-70f3-8670-634170bcb4bc) button in order to manually force the retrieval of
messages from this email box.

<a id="element-01a1452e-131c-76d3-91c3-5b62fafe0111"></a>

Browse retrieved messages in Logs > Messages.

<a id="element-01a1452e-131c-758a-9c5b-f5b6566f5b7c"></a>

![Credentials: Browse retrieved messages in Logs > Messages.](https://docs.mintsd.com/api/reader/assets/assets/images/image471.jpeg?v=aa6f3b8907144146be29a28ae8d6de88a97b28b0bd5bfe9fff927a2bc7689584)

<a id="element-01a1452e-131d-7e31-9272-8dfe4530b8f6"></a>

<a id="element-01a1452e-131d-71a0-98ab-542b38bf7fe1"></a>

<a id="element-01a1452e-131d-7371-a3e2-ae6a1e154668"></a>

In the **Accounts** view, use the ![Edit](https://docs.mintsd.com/api/reader/assets/assets/images/image89.png?v=702adcf46ea452d46f158b0c91e923f5b40ae6f37d95ca5764e20654a2855c4c#element-01a1452e-131d-7e31-9272-8dfe4530b8f6) or ![Delete](https://docs.mintsd.com/api/reader/assets/assets/images/image202.png?v=1ae492635a6fc6619d5b242c62eff118e37d8d48440153360fc4ec4913f5ed3a#element-01a1452e-131d-71a0-98ab-542b38bf7fe1) in the **Action** column to update or remove a mailbox.

