Configure POP3 mail server
- Last UpdatedNov 26, 2025
- 3 minute read
You can configure POP3 settings in Central Configuration to allow the Work Tasks communication service to fetch emails from a mail server.
Note: When sending an email, if the From mail is not set in the mail settings on the Manage Repository page, the email will be sent from Work Tasks SaaS <noreply.cloud@aveva.com> by default. However, if the From mail is set, that email will be used instead. For POP3 email users, we recommend setting the same From mail in the mail settings on the Manage Repository page.
There are two types of authentications supported for POP3:
-
OAuth2 (Recommended)
-
Basic
Configure POP3 using OAuth2 authentication
OAuth2 provides secure token-based authentication. Use the following fields to configure the POP3 mail server:
Configuration fields - OAuth2
|
Parameter |
Description |
Example Value |
|---|---|---|
|
Mail Server Configuration |
Protocol selected |
POP3 (default) |
|
Host |
POP3 server address |
outlook.office365.com |
|
Port |
POP3 port number |
995 |
|
Time Interval |
Time interval in hh:mm:ss format |
0.00:00:15 (15 seconds) |
|
Is SSL Enabled? |
Enables SSL encryption |
True |
|
Authentication |
Login method |
OAuth2 |
|
User Account |
POP3-enabled email address |
user@domain.onmicrosoft.com |
|
OAuth2 Token URI |
URI to obtain the access token |
https://login.microsoftonline.com/<<TenantID>>/oauth2/v2.0/token |
|
Authorization Code URI |
URI to obtain authorization code |
https://login.microsoftonline.com/<<TenantID>>/oauth2/v2.0/authorize |
|
Client ID |
OAuth2 application client ID |
Copy from POP3 App registrations |
|
Client secret |
OAuth2 application client secret |
Copy from POP3 App registrations |
|
Redirection URI |
URI where the user is redirected after login/authorization |
https://<MachineName>:8001/CentralConfig/ConfigMailServer.aspx |
|
OAuth2 Scope |
Permissions requested |
https://outlook.office.com/POP.AccessAsUser.All offline_access |
|
Parameters |
Additional parameters required for OAuth2 authentication |
&prompt=consent&access_type=offline |
|
Token Refresh |
How long the access token is valid before it needs refreshing (must be < 1 hour) |
0.00:50:00 |
Steps to configure
-
Open the Central Configuration page.
-
Navigate to Mail Server Settings > Manage POP 3 Server Settings.
-
Enter the OAuth2 configuration details (as listed above).
-
Click Save to store the settings.
-
Click Get Access Token.
-
You will be redirected to log in to your O365 account.
-
Click Continue to verify and grant access.
Configure POP3 using Basic authentication
This method uses a username and an app-specific password (e.g., generated from Gmail or O365).
Configuration fields - Basic authentication
|
Parameter |
Description |
Example Value |
|---|---|---|
|
Mail Server Configuration |
Protocol selected |
POP3 (default) |
|
Host |
POP3 server address |
POP3 Host |
|
Port |
POP3 port number |
995 |
|
Time Interval |
Time interval in hh:mm:ss format |
0.00:00:15 (15 seconds) |
|
Is SSL Enabled? |
Enables SSL encryption |
True |
|
Authentication |
Login method |
Basic |
|
User Name |
POP3-enabled email address |
user@gmail.com |
|
Password |
App password for the email (generated through two-step verification) |
Gmail App Password |
Steps to configure
-
Open the Central Configuration page.
-
Navigate to Mail Server Settings > Manage POP3 Server Settings.
-
Enter the configuration values from the table above.
-
Click Add Users, and provide the Username and Password.
-
Click Save.
-
Go to Manage Repository > Mail Settings.
-
Update the From Mail and Exception To Mail fields.
Notes:
- Use the same email address for both the From Mail field (under Manage Repository) and the POP3 Username.
- The mail host must be configured with a valid username and password.
- To enable email-based interaction for any Human Activity (Task, Approval, Choice,
and Checklist), you must enable the Mail delivery channel for that activity. Refer
to Delivery Channels - MailWorkList for instructions.