IMAP / SMTP email
PDF

Add IMAP/SMTP email provider

Products
All Creatio products

You can add an IMAP/SMTP email service provider using several methods.

Method 1. Add the IMAP/SMTP provider from the [Email] tab of the communication panel 

  1. In the communication panel, click btn_com_email_tab.png to open the Email tab.

  2. Click btn_products_change_field.png and select the New email account action (Fig. 1).

    Fig. 1 Adding a new email account
    scr_chapter_imap_synchronisation_ccrd_new_email.png

    Note. You can also add a new email account by selecting Go to mailbox settings actions under btn_products_change_field00001.png and clicking New on the page that opens.

  3. Enter the email address in the displayed New email account window, and click Next.

  4. Click the Add New Server button.

    Note. Add the domains of a new provider to the Email providers domains lookup to have Creatio automatically identify this email provider in the future. As a result, users will not have to specify the mail provider manually when setting up an email account.

  5. On the opened page, click Add (Fig. 2).

    Fig. 2 Adding a new email provider
    scr_chapter_imap_synchronisation_wnd_new_provider.png
  6. On the page that opens, select “IMAP” in the Service type field.

  7. Enter two required parameters: the “Inbound mail server (IMAP)” in the “imap@domain.com” format and the “Outgoing mail server (SMTP)” in the smtp@domain.com format (Fig. 3).

    Fig. 3 Setting up the IMAP/SMTP email service provider
    scr_chapter_imap_synchronisation_wnd_new_provider_settings.png
  8. The rest of the IMAP/SMTP server settings will be populated automatically. You can change them by selecting the needed option from the drop-down list to configure the mail server port and the security parameters.

    Set the inbound mail server port:

    1. Select “143” to use the port without encryption.

    2. Select “993” to use the port for a secure connection.

    Set the security parameters of the inbound mail server:

    1. Select “SSL/TLS” to use the standard data security protocol.

    2. Select “STARTTLS” to use the common protocol extension.

    3. Select “None” to disable the inbound mail data security.

    Set the outgoing mail server port:

    1. Select “587” to use the port without encryption.

    2. Select “455” to use the port for a secure connection.

    Set the security parameters of the outgoing mail server:

    1. Select “SSL/TLS” to use the standard data security protocol.

    2. Select “None” to disable the outgoing mail data security.

  9. Specify additional settings.

    Set up the mailbox login format:

    1. Select the Use manual entry option if users enter their email address and username.

    2. Select the Use email address option if the full email address is used as a login (for instance, “example@google.com”).

    3. Select the Use mailbox name option if the part of the email address before “@” is used as a username. For example, the “test” will be a login for “test@google.com” email address.

    Set up the authentication method:

    1. Select “Basic” for the basic authentication using the user name and password with Base64 encryption.

    2. Select “OAuth 2.0” to restrict the service access to protected user resources without the need to pass the login and password. Populate the Application (client) ID and Client secret required fields. Application (client) ID is generated by the authentication server of the mail service. The documentation and API may refer to the application ID as “Product ID.” Client secret – a secret key generated by the authentication server. The documentation and API may refer to the client secret as “Product key.”

  10. Save the settings by clicking Apply.

    As a result, system users will be able to use the mailboxes of this provider to send and receive email messages.

Method 2. Add the IMAP/SMTP provider from the user profile 

  1. Open the user profile page by clicking the Profile image button on the main page of the application.

  2. Click Email accounts (Fig. 1).

    Fig. 1 Opening the email accounts
    scr_chapter_imap_synchronisation_ccrd_profile_new_email.png
  3. Click New in the opened window.

  4. To complete the setup, perform steps 310, described above in Method 1.

    Note. To delete a mail server, delete all its mailboxes (email accounts) first.