Email Notification Settings
This guide explains how to configure Teleskope email settings in order to send policy violation alert emails from your organization's domain using SendGrid domain authentication.
Overview
Teleskope sends policy violation alerts via email through SendGrid. By default, emails are sent from [email protected]. To send emails from your own domain, configure the sender address in Teleskope and add DNS records to your domain so SendGrid can send on your behalf.
Step-by-Step Setup
Navigate to Email Settings
Go to Settings > Notification Settings in Observatory.
Configure the Sender Email Address
The sender email is composed of three parts:
[User] @ [Subdomain] . [Domain]User: the local part of the email (e.g.,
alerts,automation)Subdomain: a subdomain you designate for sending (e.g.,
notifications,em)Domain: your organization's domain (e.g.,
yourcompany.com)
Example: [email protected]
Fill in all three fields and click the Save icon.
Set the User Name
Enter the name that appears in the "From" field of the email (e.g., "Teleskope Alerts", "Security Team"). Click Save.
Add DNS Records to Your Domain
After saving the domain settings, a table of DNS records appears at the bottom of the page. These records are generated by SendGrid and must be added to your domain's DNS configuration.
The table shows:
Status
Pending (not yet verified) or Verified (DNS propagated)
Type
The DNS record type (CNAME or TXT)
Host
The DNS hostname to create
Value
The value to set for that record
There are two categories of records:
Domain Authentication (typically 3 CNAME records) These prove to email providers (Gmail, Outlook, etc.) that SendGrid is authorized to send email on behalf of your domain. They enable DKIM signing and SPF alignment.
Link Branding (typically 2 CNAME records)
These rewrite tracking links in the email body to use your domain instead of sendgrid.net, improving deliverability and trust.
How to add the records:
Log in to your DNS provider (e.g., Cloudflare, Route 53)
For each row in the table, create a DNS record with:
Type: as shown (usually CNAME)
Name/Host: as shown in the Host column
Value/Target: as shown in the Value column
TTL: default (or 3600)
Wait for DNS Propagation
DNS changes can take up to 48 hours to propagate, though most complete within minutes to a few hours. Teleskope automatically checks verification status with SendGrid each time you load the settings page.
Once all records show Verified, your domain is authenticated and emails will be sent from your configured address.
Optional: Configure CC Emails
Enter a comma-separated list of email addresses that should be copied on every policy alert email. Click Save.
Optional: Configure Reply-To
Set a Reply-To name and email address. When recipients reply to an alert email, the reply goes to this address instead of the sender. Click Save.
Optional: Set a Logo URL
Enter a URL to your organization's logo (PNG or JPG). This logo will appear in the header of policy alert emails. Click Save.
Troubleshooting
DNS records show "Pending" after 48 hours
Verify the records were added correctly in your DNS provider. Check for typos in the Host or Value fields. Some providers require you to omit the base domain from the Host (e.g., enter em1234 instead of em1234.yourcompany.com).
Emails not being received Check that the domain is verified (all records show "Verified"). Check the recipient's spam/junk folder. Ensure the sender address is not blocked by the recipient's email provider.
"Failed to load DNS records" error This indicates a connectivity issue with SendGrid. Try refreshing the page. If the issue persists, contact Teleskope support.
Settings Reference
User
Local part of sender email
alerts
Subdomain
Sending subdomain
notifications
Domain
Organization domain
yourcompany.com
User Name
Display name in "From" field
Teleskope Alerts
Reply To Name
Name shown when recipient replies
Security Team
Logo URL
URL to logo image for email header
https://cdn.co.com/logo.png
Last updated
Was this helpful?