Create an email account
- UpdatedAug 1, 2024
- 3 minutes to read
- Xanadu
- Notifications
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
Procedure
- Navigate to All > System Mailboxes > Administration > Email Accounts, and then click New.
-
On the form, fill in the fields.
Field Description 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
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.
- Click Submit.
-
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.
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
What to do next