Creating an email account

Use the Email Account form to configure email accounts that manage outgoing (sender) and incoming (receiver) email. You specify email addresses sending and receiving emails, SMTP host information, user IDs, passwords, and more. When you configure email for your application, you reference the Email Account name in the email listener's Email Account field so the listener can get the necessary information to route incoming and outgoing messages.
  1. In the navigation panel of Dev Studio, click Records.
  2. Expand the Integration-Resources category, and then click Email Account.
  3. Click Create.
  4. On the Create Email Account page, enter a short description and an account name.
  5. Click Create and open.
  6. In the Account provider section, from the Email provider list, click Select Provider and choose an email provider.
    Result: When you make a selection, some fields, such as Host, Port, and Protocol, automatically populate. You can edit the information in these fields.
  7. In the Sender section, in the Identity subsection, configure the identity information:
    1. In the Email address field, enter the email address that is associated with email sent from this account.
    2. In the Display name field, enter the name to display for this sender.
    3. In the User ID field, enter the SMTP user ID that sends email from this host.
    4. In the Password field, enter the sender password.
    5. In the Reply to field, enter the email address to which the recipients of emails that are sent from this account can reply. Use a working, valid email address that is reviewed by a person or is processed by the system.
  8. In the Connection subsection, configure the connection information:
    1. In the SMTP host field, enter the host name or IP address of the SMTP server for outgoing mail.
    2. In the Port field, enter the SMTP server port number for outgoing email connections:
      The following default outgoing email connection options are available:
      • 25 (unsecured)
      • 587 (STARTTLS)
      • 465 (SMTPS)
    3. Optional: To use SSL to send email messages through this server, click the Use SMPTS check box. Do not select this option if the email server uses STARTTLS.
  9. If you want to enable digitally signed email for your application, in the Message signing section, configure the keystore settings:
    1. In the Keystore instance field, enter a Keystore data instance. For more information, see Keystores.
    2. Optional: In the Alias field,choose the alias of the key in the keystore to use for signing.
      If you leave this field blank, the system selects the first key in the keystore.
  10. Optional: To override the email sender default settings, in the Advanced section, update the settings:
    Note: Customize the email sender with these settings carefully because they might result in an unproven, unsupported configuration.
    For example: You can disable plain authentication for compatibility with some Microsoft Exchange servers by entering the following values:
    • In the Key field, enter mail.imaps.auth.plain.disable.
    • In the Value field, enter true.
  11. In the Receiver section, configure the receiver information to use when an email listener polls an inbox for messages to process (requests from customers):
    1. In the Identity subsection, in the User ID field, enter the email address to use to receive email.
    2. In the Password, enter the receiver password.
      To populate the User ID and Password fields with the user ID and password from the Sender subsection, click Use sender's ID and password.
    3. In the Connection subsection, in the Host field, enter the POP3 or IMAP mail server host name or IP address to use to receive incoming email.
    4. 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).
    5. From the Protocol list, select the server email protocol.
    6. To use SSL to send email messages through this server, click the Use SMPTS check box. Do not select this option if the email server uses STARTTLS.
  12. 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 com.sun.mail.imap and com.sun.mail.pop3, respectively.
    Note: Customize the email receiver with these settings carefully because they 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.
  13. Click Save.