Skip to content
Mint Service Desk Documentation centre

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 ProviderCredentials SupportNotes
GmailLimitedApp password required and IMAP must be enabled. Standard account password does not work when 2FA is enabled.
YahooYesApp password required after enabling 2FA.
Microsoft Office 365LimitedBasic Auth over IMAP/SMTP may be disabled by the organization’s policy. Works only if Basic Auth is still enabled.
Microsoft Graph APINoOnly OAuth2 authentication is supported. IMAP/SMTP with user password is not available.

SMTP settings

SMTP Server Parameters (Credentials)

Mail ProviderSMTP ServerSMTP PortSMTP Security
Gmailsmtp.gmail.com465SSL/TLS
Yahoosmtp.mail.yahoo.com465SSL/TLS
Microsoft Office 365smtp.office365.com587STARTTLS
Microsoft Graph APINot applicableNot applicableNot applicable

IMAP settings

IMAP Server Parameters (Credentials)

Mail ProviderIMAP ServerIMAP PortIMAP Security
Gmailimap.gmail.com993SSL/TLS
Yahooimap.mail.yahoo.com993SSL/TLS
Microsoft Office 365outlook.office365.com993SSL/TLS
Microsoft Graph APINot applicableNot applicableNot applicable

Account configuration

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

Complete the following fields:

FieldDescription
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 addressesOptional 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.