> ## Documentation Index
> Fetch the complete documentation index at: https://v1-docs.adapt.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# SendGrid

> Connect SendGrid to Adapt to send email and review delivery data

Twilio SendGrid is an email delivery platform for transactional and marketing
email. Connect it to Adapt with a SendGrid API key.

## Set up credentials

**1. Open API Keys settings**

Sign in to SendGrid and go to **Settings > API Keys** in the left navigation.

> [!NOTE]
>
> Two-factor authentication must be enabled on your account before you can
> create an API key.

**2. Create an API key**

Click **Create API Key** and give the key a name.

**3. Choose Restricted Access**

Select **Restricted Access** and grant the permissions you need. For sending,
enable **Mail Send**; add read access to Stats and Suppressions to review
delivery data.

**4. Create and copy the key**

Click **Create & View**, then copy the key (it starts with `SG.`).

> [!NOTE]
>
> The key is displayed only once. Store it securely before leaving the page.

## Connect to Adapt

**1. Open Integrations**

In Adapt, go to **Settings > Integrations**.

**2. Find SendGrid**

Search for **SendGrid** and select it from the catalog.

**3. Start the connection**

Click **Connect** to open the connection form.

**4. Add your credentials**

Enter the values you gathered above, then click **Add connection**:

| Secret Name | Value |
| - | - |
| `SENDGRID_API_KEY` | Your SendGrid API key |

You can rename the connection and choose whether it is shared with your
organization or kept personal to you.

**5. Test the connection**

Ask Adapt about your recent email delivery stats.

### Security

* Credentials are encrypted at rest with AES-256
* Use Restricted Access and grant only the scopes you need, such as Mail Send
* Rotate keys periodically; you can delete and recreate a compromised key without changing other credentials
* Never share your API key or commit it to source control

## Capabilities

Send email through SendGrid, and review delivery stats and suppression lists
from Adapt.

### Examples

Send an email:

```
Send an email through SendGrid to lead@example.com about our new pricing.
```

Review delivery stats:

```
Show my SendGrid open and click rates for the past 7 days.
```

Check suppressions:

```
Is jane@example.com on any SendGrid suppression list?
```

Investigate bounces:

```
List SendGrid bounces from yesterday and summarize the bounce reasons.
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.