# SendGrid

## Overview

Many organizations elect to trigger an email notification or email-based workflow when the Identity Intelligence security platform has a new finding or actionable alert.  Please see the [#example-use-case-sendgrid](#example-use-case-sendgrid "mention")section below for more details.  

Up to this point, this email would come from a cisco.com domain. For a more flexible seamless process, Identity Intelligence has introduced the ability to configure several of the top mail providers. 

In the Integrations tab, there is a new section for “Email”, which includes options to set up integrations for your own SendGrid service. 

## Prerequisites

This article assumes that your organization has a Sendgrid implementation and you have necessary admin rights to configure it.  

## SendGrid Configuration

1. Go to the Integrations tab and select **Add Integration**
2.  Scroll to the **Email** section and select the SendGrid Integration
3. Fill in the following fields and click **Save** when completed:

* **Name** - this is a display name in the Identity Intelligence UI for the integration
* **Description** - optional
* **From Address** - this can take the form of either of the following:  
  * An email address on an authenticated domain as explained in <https://docs.sendgrid.com/ui/account-and-settings/how-to-set-up-domain-authentication>
  * A verified Single Sender Identity as explained in <https://docs.sendgrid.com/ui/sending-email/sender-verification>
* **Default email service** (toggle) - enable this option to make this email integration the default provider from which email notifications will be sent
* **API Key** - Create an API Key as described [in this article](https://docs.sendgrid.com/ui/account-and-settings/api-keys#creating-an-api-key), with **Full Access**.&#x20;

<figure><img src="/files/NCH4nTCA7wzcLS0xaa2Z" alt=""><figcaption></figcaption></figure>

## Test Connectivity

After the integration is created, you can test connectivity to the service using the 3-dot menu option on the integration row and select **Test Connectivity.**&#x20;

<figure><img src="/files/b38Q06STgiNJypATRDEK" alt=""><figcaption></figcaption></figure>

## Example Use Case - SendGrid

Organizations may find that their users are connecting to corporate systems and applications while using personal 3rd party VPN services like NordVPN or ExpressVPN, or less reputable ones than that.  This is a bad security practice and many companies prohibit this within their acceptable use policy. &#x20;

Identity Intelligence surfaces personal VPN usage in the [Personal VPN Usage](/understanding-check-failures/oort-insights/identity-posture-management-insights/personal-vpn-usage.md) check. Using the check settings menu, you can configure Identity Intelligence to send email messages to users (or their managers, if defined in the primary IDP), informing them of this policy violation. &#x20;

With the SendGrid integration configured above and set to Default Email Service, **this email will now originate via SendGrid from the sending From address list**. &#x20;

<figure><img src="/files/0zgAoejma9gwys2796YR" alt=""><figcaption></figcaption></figure>

You can also customize the message sent to the end user per Check via the [Check Settings](/understanding-check-failures/customizing-checks.md#notification-settings). &#x20;

<figure><img src="/files/YJZmDGvXKvMcngtTHFpG" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.oort.io/integrations/sendgrid-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.