Configure an email account to determine the email server and account details for receiving email in your application. These accounts are used in the email listener and email channel to read emails and create or update cases, or send automatic replies and notifications.
- In the navigation pane of Dev Studio, click Records.
- Expand the Integration-Resources category, and then click Email Account.
- Click Create.
- On the Create Email Account page, enter a short description and an account name.
- Click Create and open.
- In the Account provider section, in the Email
provider list, select an email provider.
Note: Make sure you are using the latest version of your email provider account. Many email providers do not provide support for end-of-life products. For more information, refer to your email provider documentation.
- In the Receiver section, in the Receive
using list, select an email protocol.
Choices Actions IMAP or POP3
- Optional: To populate the User ID and Password fields with the user ID and password from the Sender subsection, select Use sender's ID and password.
- In the Identity section, in the User ID field, enter the email address to use for incoming email.
- In the Password field, enter the recipient password.
- In the Connection section, in the Host field, enter the POP3 or IMAP mail server host name or IP address to use for incoming email.
- In the Port field, enter the POP3 or
IMAP mail server port number for email connections.The following port numbers are available:
- For IMAP servers, ports 143 (unsecured) or 993 (secured with SSL).
- For POP3 servers, ports 110 (unsecured) or 995 (secured with SSL).
Microsoft Graph Note: Microsoft Graph appears only if you select Microsoft Office 365 in the Email provider list in step 6.
- In the Identity subsection, in the
User principal name field, enter
the user principal name that is associated with the inbox in
which you want to receive email.Typically, the user principal name is the same as the email account ID, but that setting depends on your Microsoft Office 365 configuration. For more information about what to enter in this field, see your Microsoft Office 365 documentation or contact your administrator.
- In the Advanced section, enter a value for the timeout key or accept the default.
- Configure the authentication for the email protocol:
Choices Actions IMAP or POP3 Note: The Use secure connection check box is selected by default. As a best practice, leave this check box selected.
- For IMAP, select the protocol to use to receive email
messages from an external server.
- In the Lowest allowable SSL/TLS
version field, select the lowest version of
the protocol that you want to allow to communicate with an
external server.The default value is TLS version 1.2.
- In the Truststore field, press the
Down arrow key and select the keystore that holds your
truststore certificates.If the keystore does not exist, you can create a new keystore by entering a name and then clicking the rule opener.
- In the Connection section, in the
Authentication profile field,
press the Down arrow key, and then select the authentication
profile for your email account.
Note: Microsoft Graph connections support OAuth 2.0 authentication profiles that use the Client credentials and Password credentials grant types. For more information, see OAuth 2.0 authentication for email providers.
- Optional: To create a new authentication profile, click the rule opener.
- For IMAP, select the protocol to use to receive email messages from an external server.
- Optional: To override the email receiver default settings, expand the
Advanced section, and then specify the key and value
for valid JavaMail API IMAP and POP3 protocol provider properties, as defined in
the Java packages
Note: Carefully customize the email receiver with these settings because changes might result in an unproven, unsupported configuration. For example: You can disable plain authentication for compatibility with some Microsoft Exchange servers. Enter the following values:
- In the Key field, enter mail.imaps.auth.plain.disable.
- In the Value field, enter true.
- Optional: To test the connectivity of your receiver configuration, click Test
Note: When you test the connectivity of your IMAP configuration, the end results indicate what type of security protocol you are using. The following scenarios are possible:
- IMAP (Connect using default) – insecure connection
- IMAP (Connect using SSL/TLS)
- IMAP (Connect using STARTTLS)
- Click Save.