You can create email accounts in addition to the accounts provisioned for you.

Before you begin

  • Role required: admin
  • Email server: a compatible email server
    • SMTP
    • POP3
    • IMAP
Warning: An SMTP server that uses a localhost or loopback (127.0.0.1) IP address is not accepted as a compatible email server. For more information, see KB0724199.

Procedure

  1. Navigate to All > System Mailboxes > Administration > Email Accounts, and then click New.
  2. On the form, fill in the fields.
    FieldDescription
    Name Name of the email account.
    Type Type of mail server. You can select one of the following:
    • POP3
    • IMAP
    • SMTP
    Note: The system can use only one active SMTP account at a time.
    Authentication Type of authentication used for the email account to connect to the email server. You can select one of the following:
    • –- None --
    • Password
    • OAUTH
    • OAUTH 2.0
    The Email - OAUTH support for IMAP and SMTP (com.glide.email.oauth) plugin must be active for the OAuth options to be visible.
    OAuth Provider

    OAuth application registry record for this account.

    This field appears if you selected OAuth 2.0.
    Server Remote server to which this account connects. To activate a server for an on-premise installation, enter the full address (FQDN) of the node (for example, node.customerdomain).
    Active Option to activate the email account.
    ServiceNow Configured Identifier of whether this account is provisioned by ServiceNow. If you create an account, this option is not selected.
    Enable debug output

    Option to create node logs for the raw data that is exchanged with the email server. You can review the node logs by navigating to System Logs > Utilities > Node Log File Browser.

    You can enable this field temporarily to diagnose issues related to receiving or sending email.
    Email user label Display value used for outgoing messages. This field is for SMTP type accounts only.
    User name User name or ID to authenticate an email address. The value in this field is also the From address when the instance sends email. If you are using SMTP, this must be a full email address. The value in the From field can override this (for SMTP accounts).
    Note: The address in the From field on the Notification [sysevent_email_action] form takes precedence over this field.
    Password Password when the Authentication type is Password.
    Note: You may need to increase the size of this field to accommodate longer passwords. By default, this field has a size of 40 characters.
    From (SMTP only) The From address used for notifications sent with this account. This address takes precedence over the User name field. If nothing is present in this field, the User name is used as the return address for notifications sent from the instance.
    Connection Security Type of secure connection. Choose a setting:
    None
    No secure protocol is used.
    STARTTLS
    Upgrades an insecure connection to a secure connection using the SSL/TLS encryption protocol, if your email server supports TLS.
    SSL/TLS
    Connect to an SSL/TLS encrypted port to secure the connection. Email is encrypted between the ServiceNow instance and your mail server.
    Warning: Selecting a less secure protocol like STARTTLS or None may expose your data. To better ensure the security of data in your email server, select SSL/TLS.
    Port Connection TCP port.
    System Address Filter

    System address filter to apply to the email account. If left blank, the system uses the default system address filter for inbound or outbound email.

    For more information, see System address filters.
  3. Click Submit.
  4. Click the test connection link at the bottom to test the SMTP, POP3, or IMAP account.

    The system displays a pop-up window with the results of the connection test.

    Connection Test pop-up window displaying the results connection successful.

    If the test succeeds, click Close to return to the email account record. If the test fails, click View Logs to display more information about the test results.

Result

The system uses the email account to send or receive email.

What to do next

Enable the system to send or receive email.