Create an email account
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
Navigate to All > System Mailboxes > Administration > Email Accounts, and then select New.
On the form, fill in the fields.
| Field | Description |
|---|---|
| Name | Name of the email account. |
| Account type |
A shared address refers to a shared mailbox that multiple users or team members can access.
A forwarding address is an email address where emails are automatically redirected or forwarded from another account. Note: Account type is specific to personal corporate mailbox. For more information,see Personal corporate mailbox. |
| 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, Microsoft Graph \(Receiving\), 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.
Upgrades an insecure connection to a secure connection using the SSL/TLS encryption protocol, if your email server supports 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. |
Select Submit.
Select 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 dialog showing a successful connection result
If the test succeeds, select **Close** to return to the email account record. If the test fails, select **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.
Parent Topic:Email accounts