Email Server

To enable email notifications in vScope, such as for Scheduled Exports, invitations, and Tracker notifications, you need to configure your own email server settings. This article guides you through the process of setting up your email server in vScope.

Note

Though some critical administrator emails will still be sent using vScope’s external email server if your email server fails, or is not configured. This includes, for example, health status and password reset links – we strongly recommend that you use your organization’s email server.

Configuring the Email Server

Using OAuth 2.0

Note

As of late August 2025, vScope only supports OAuth for Microsoft email servers.

1. Log in as an Administrator, then go to Settings > Email Integration.
2. Enter the OAuth settings by filling in the Tenant ID, Client ID, and Client Secret for your configuration.
3. Click Save to apply your email server settings.

Learn more

• Authenticate an IMAP, POP, or SMTP connection using OAuth

Using Plain Authentication Method (Username / Password)

1. Log in as an Administrator, then go to Settings > Email Integration.

2. Fill in the following details for your SMTP server:

   • SMTP Server: Enter the full address of your SMTP server (e.g., smtp.yourcompany.com).
   • Port: Specify the port number used by your SMTP server (e.g., 587 for TLS/STARTTLS or 465 for SSL).
   • Sender Address: Provide the email address that will appear as the sender for all vScope notifications.
   • SMTP Authentication: If your SMTP server requires authentication, check this box and enter the required Username and Password for the server.

3. Click Save to apply your email server settings.

Tip

After saving your configuration, you can send a test email to confirm that vScope is successfully connected to your email server and can send notifications. This helps verify your settings instantly.

---

Troubleshooting

Here are some common email server errors you might encounter and how to troubleshoot them:

550 5.4.1 Recipient address rejected: Access denied

This error typically indicates that the recipient’s email address is invalid or does not have an active mailbox.

• Check email addresses: Verify the spelling of all recipient email addresses registered in vScope.
• Verify mailbox existence: Ensure that the recipient email addresses correspond to a registered and active mailbox (e.g., in Microsoft Exchange or your email service).

For more detailed information, refer to the Microsoft support article on error 550 5.4.1.

550 5.7.1 Relaying denied

This error occurs when the email server refuses to relay emails from the sender. This can be due to security policies that prevent unauthorized email relaying.

• Verify recipient mailbox: Confirm that all recipient email addresses in vScope correspond to a registered mailbox (e.g., in Microsoft Exchange). Incorrect or non-existent recipient mailboxes can sometimes trigger this error.
• Check SMTP authentication: Ensure that if your SMTP server requires authentication, the SMTP Authentication checkbox is selected and the correct Username and Password are provided in vScope.
• Server relay settings: Your email server might be configured to deny relaying for unknown senders or IP addresses. Consult your email server administrator to ensure vScope’s outgoing connections are permitted to relay emails.

java.net.SocketTimeoutException

This error indicates that the vScope application timed out while trying to communicate with your email server. The email server is not responding within the expected time frame. Common causes include:

• Message throttling: If you are using an Exchange server, it might have message throttling enabled. A large number of queued emails sent within a short period can trigger throttling, causing the server to delay responses.
• Network connectivity issues: There might be network latency or an issue preventing data transfer between vScope and the mail server within the specified timeout interval.
• Network security rules: Inbound or outbound rules in your network security group (e.g., firewalls, security appliances) might be blocking the communication or acknowledgment messages from the email server. Ensure that the necessary ports are open and no rules are interfering with vScope’s connection to your SMTP server.