Notifications

Configuring Email Notifications

To configure email notifications click + Add Email Server.

This will bring you to the Email Notifications screen.

The form requires that the following fields be filled out:

Basic Details

• To Email Address: The email address that will receive the notifications. This field is limited to one email address.
• From Email Address: The email address listed in the 'sender address' (or 'from') field of notification emails sent by Hub. In many cases, this will match the email whose settings are configured in the 'Email Server Settings' section below, though a different email (such as no-reply@email.com) can be configured here. If a user were to hit  'reply' on an email notification, this is the email the reply would be sent to.
• Subject Prefix (optional): The prefix appended to the subject line of the Error Notification emails. This defaults to [Tasktop] but can be edited if needed. This can help users filter email notifications from Tasktop based on prefix.
• Tasktop Server URL: The URL used to access your instance of Hub. This is used to construct links to errors and issues in the notification emails.
• Notification Frequency: The frequency of email notifications. Emails will contain a count of new issues and errors since the last notification and will only send if a new error or issue has occurred since the prior email.

Email Server Settings

These are the email server settings that allow Hub to send notifications.

• Username (optional): Username for the authenticated SMTP server.
• Password (optional): Password for the authenticated SMTP server.
• SMTP Server: The SMTP host name of your mail server. 
• SMTP Port: The SMTP Port number to use.
  • If Protocol = SMTP, the value for this will typically be 25.  
  • If Protocol = SMTPS, the value for this will typically be 465.
  • If Protocol = SMTP_STARTTLS, the value for this will typically be 587, but can also be port 25.
• Connection Timeout: Specifies the maximum period, in seconds, that establishing an email server connection is permitted to take. This defaults to 60 seconds, which should cover most scenarios.
• Protocol
  • SMTP: Basic unencrypted SMTP Protocol.  
  • SMTPS: A more advanced, encrypted SMTP Protocol (SMTP Secure), which will perform server certificate validation.
  • SMTP_STARTTLS: A modern protocol that wraps the unencrypted SMTP protocol in TLS (formerly known as SSL encryption), and will perform server certificate validation. This will attempt the STARTTLS wrapper, but if it is not supported by the server, the client will fall back to basic SMTP.

Note: Google email users should select SMTP_STARTTLS.

Here's an example of a filled in form:

You can test your email server settings by clicking Test Connection.

Or, send a test email by clicking Send Test Email.

Once settings are filled in and the connection has been tested, click Save to save your settings.

Click Turn On Notifications to enable email notifications.

Once saved, you can turn email notifications on or off and delete the notification settings from the Notifications screen. You can also click Configure Notification Settings to modify your existing settings:

Note: If an email notification fails, an issue will be surfaced on the Activity screen in Hub.