Email Account Setup

SuiteCRM allows you to configure personal outbound and inbound email accounts, enabling you to send and receive emails directly within the Emails module. This section covers how to set up both account types from your user profile.

System administrators can also configure personal email accounts on behalf of other users from the Admin panel.

The configuration of system-wide outbound email accounts and group email accounts (shared mailboxes used by multiple users) is the responsibility of your system administrator and is not covered in this guide.

Setting Up a Personal Outbound Email Account

A personal outbound email account allows you to send emails from within SuiteCRM using your own email address.

To set up a personal outbound email account:

  1. From the Navigation Bar, hover over your username in the top-right corner of the screen and click Edit Profile.

  2. Hover over Users in the top-left corner and click Outbound Email Accounts.

    Navigating to Outbound Email Accounts from the Users menu

  3. Hover over Outbound Email Accounts in the top-left corner and click New Personal Account.

    New Personal Account option in the Outbound Email Accounts menu

  4. The creation screen is divided into three sections. Complete each section as follows:

    Basic

    • Name: A descriptive name for this account, for example "My Work Email."

    • Type: This will be set to Personal automatically and cannot be changed.

    • Owner: Owner of the email account.

    • Auth Type: Select the authentication type required by your mail server. Options include No Auth, Basic Auth (username and password), and OAuth. If you are unsure which to use, contact your system administrator.

    Server Configuration

    • Server: Enter the address of your outgoing mail server (SMTP server).

    • Mail SMTP/SSL: Select the security protocol required by your mail server, such as SSL or TLS.

    • Port: Enter the port number used by your outgoing mail server. The default value is 25, however common alternatives are 465 (SSL) or 587 (TLS).

    • Username: This will be pre-populated with your SuiteCRM username.

    Outbound Configuration

    • "From" Name: The name that will appear in the From field when you send emails.

    • "From" Address: The email address that emails will be sent from. This is a required field.

    • "Reply-To" Name: The name that will appear in the Reply-To field, if different from the From Name. This is optional.

    • "Reply-To" Address: The email address that replies will be sent to, if different from the From Address. This is optional.

    • Signature: Use the built-in editor to create an email signature that will be appended to emails sent from this account. You can format the signature using the toolbar provided.

  5. Once all details have been entered, click Send Test Email to verify the connection is working correctly. A pop-up will appear asking you to enter an email address to send the test to.

  6. If the test is successful, click Save to store the account settings.

If you are unsure of the mail server settings required for your email account, contact your system administrator or refer to the documentation provided by your email provider.

Setting Up a Personal Inbound Email Account

A personal inbound email account allows you to view emails from your personal mailbox within the SuiteCRM Emails module. Emails from a personal inbound account are not automatically stored in SuiteCRM. They must be manually imported if you wish to log them against a record.

To set up a personal inbound email account:

  1. From the Navigation Bar, hover over your username in the top-right corner of the screen and click Edit Profile.

  2. Hover over Users in the top navigation bar and click Inbound Email Accounts.

  3. Hover over Inbound Email Accounts and click New Personal Account.

  4. The creation screen is divided into three sections. Complete each section as follows:

    Basic

    • Name: A descriptive name for this account, for example "My Work Email."

    • Type: This will be set to Personal automatically and cannot be changed.

    • Status: Set to Active by default. This controls whether the account is actively monitored.

    • Owner: This will be pre-populated with your username.

    Server Configuration

    • Auth Type: Select the authentication type required by your mail server. Options include Basic Auth (username and password) and OAuth.

    • Mail Server Address: Enter the address of your incoming mail server (IMAP server).

    • Protocol: The protocol is set to IMAP and cannot be changed, as SuiteCRM uses IMAP for inbound email.

    • Mail Server Port: Enter the port number used by your incoming mail server. The default value is 143.

    • Use SSL: Check this box if your mail server requires a secure SSL connection.

    • User Name: Enter the username for your email account, typically your full email address.

    • Password: Enter the password for your email account.

    • Monitored Folders: Select the mail folders that SuiteCRM should monitor for incoming emails, typically your Inbox. Click Select to connect to your mail server and choose the relevant folders from the pop-up.

    • Trash Folder: Select the folder used as your email trash or deleted items folder. Click Select to choose from the available folders.

    • Sent Folder: Select the folder used to store sent emails. Click Select to choose from the available folders.

    • Connection String: This is an optional field. Leave blank unless you have been advised by your system administrator to use a specific connection string.

    • Email Body Filter Type: Controls how the email body is searched within SuiteCRM. The default setting is Multi Word Search, which is suitable for most users.

    Outbound Configuration

    • Outbound Email Account: Select the outbound email account to be used when replying to emails received in this inbound account. Click the selector icon to search for and link an existing outbound account.

    • Signature: Select the email signature to be used when composing emails from this account. The Default Signature will be used unless another is selected.

    • "From" Name: The name that will appear in the From field when sending emails from this account.

    • "From" Address: The email address that emails will be sent from.

    • "Reply-To" Name: The name that will appear in the Reply-To field, if different from the From Name. This is optional.

    • "Reply-To" Address: The email address that replies will be directed to, if different from the From Address. This is optional.

  5. Once all server details have been entered, click Test Connection Settings in the top-right corner of the screen to verify that SuiteCRM can connect to your mail server successfully before saving.

  6. Click Save to store the account settings.

If you are unsure of the mail server settings required for your email account, contact your system administrator or refer to the documentation provided by your email provider. If your organisation uses OAuth-based authentication such as Microsoft 365 or Google Workspace, your system administrator will need to configure the OAuth connection before you can complete this setup.

Content is available under GNU Free Documentation License 1.3 or later unless otherwise noted.