Credentials
Connect a mailbox with its username, password and incoming and outgoing server settings. Check provider requirements, activate the account and retrieve messages.
Credentials authentication uses the mailbox username and password, plus the incoming and outgoing mail server addresses, ports and security settings.
Connection requirements
Requirements for successful mailbox configuration:
- 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
The three tables below present the Credentials Authentication Support, SMTP server parameters, and IMAP server parameters for specific email providers.
Credentials support
Credentials Authentication Support
| 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. |
SMTP settings
SMTP Server Parameters (Credentials)
| 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 |
IMAP settings
IMAP Server Parameters (Credentials)
| 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 |
Account configuration
The screenshot below shows the fields required for Credentials authentication in Mint Service Desk.
Complete the following fields:
| 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. |
After completing the fields, click button to finish the process and save the new email account.
Connection and activation
If the connection fails, an error appears when you try to save.
After a successful save, the account appears on the Accounts list.
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 will appear in the Error occurred column.
To activate your new account, press the button. If for some reason you want to deactivate it, you can easily do it, using button.
Once you have a working email account added to the system you can use the button in order to manually force the retrieval of messages from this email box.
Browse retrieved messages in Logs > Messages.
In the Accounts view, use the or in the Action column to update or remove a mailbox.