> ## Documentation Index
> Fetch the complete documentation index at: https://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

<Steps>
  <Step title="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.
    </Note>
  </Step>

  <Step title="Create an API key">
    Click **Create API Key** and give the key a name.
  </Step>

  <Step title="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.
  </Step>

  <Step title="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.
    </Note>
  </Step>
</Steps>

## Connect to Adapt

<Steps>
  <Step title="Open Integrations">
    In Adapt, go to **Settings > Integrations**.
  </Step>

  <Step title="Find SendGrid">
    Search for **SendGrid** and select it from the catalog.
  </Step>

  <Step title="Start the connection">
    Click **Connect** to open the connection form.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Test the connection">
    Ask Adapt about your recent email delivery stats.
  </Step>
</Steps>

### 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.
```