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

# SendGrid

> Connect Twilio SendGrid to Myrmex with an API key — create the key, verify a sender, and add the integration.

import { Note, Steps, Step, CardGroup, Card, Tip } from '@mintlify/components';

Connect **Twilio SendGrid** so Myrmex can send email — notifications, reports, and alerts — through the SendGrid Mail API (v3). Myrmex calls the API live using a SendGrid API key, sending on demand, with nothing stored on the Myrmex side.

## What Myrmex Can Do

<CardGroup cols={2}>
  <Card title="Send notifications" icon="bell">
    Deliver alert and incident emails from your workflows.
  </Card>

  <Card title="Send reports" icon="paper-plane">
    Email investigation and posture summaries on demand.
  </Card>

  <Card title="Per-sender setup" icon="at">
    Each integration is tied to one verified sender address.
  </Card>

  <Card title="Automate delivery" icon="link">
    Let [Hydra](/documentation/multi-agent-system/integration-specialist-agent) send email as a step in an automated response.
  </Card>
</CardGroup>

## Before You Start

* A **Twilio SendGrid** account.
* A **verified sender identity** (Single Sender Verification or an authenticated domain) for the From address.
* Permission to create **API keys**.

## Step 1 — Create the API Key in SendGrid

SendGrid authenticates with an API key that Myrmex sends as a bearer token.

<Steps>
  <Step title="Sign in to SendGrid">
    Log in with an account that can manage API keys.
  </Step>

  <Step title="Create the API key">
    Go to **Settings → API Keys → Create API Key**, name it (for example `Myrmex`), and grant at least **Mail Send** permission (Restricted Access recommended).
  </Step>

  <Step title="Copy the key">
    Copy the key immediately — it's shown only once.
  </Step>

  <Step title="Verify the sender">
    Under **Settings → Sender Authentication**, verify the From address (Single Sender) or authenticate your domain.
  </Step>
</Steps>

<Tip>
  Grant the key only **Mail Send** access. Create one integration per verified sender address.
</Tip>

## Step 2 — Add the Integration in Myrmex

From the **Directory**, choose **Add Integration → SendGrid**, then fill in:

| Field                 | Description                                                                                                                           |
| --------------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| **Name**              | A unique name for this SendGrid instance.                                                                                             |
| **Description**       | Optional note to identify it.                                                                                                         |
| **API Token**         | The SendGrid API key from Step 1 (sent as a bearer token).                                                                            |
| **Region / Base URL** | SendGrid API host — `api.sendgrid.com` (US, default) or `api.eu.sendgrid.com` (EU subusers). No scheme; https is added automatically. |
| **Verify SSL**        | Validate TLS certificates. Keep enabled for public SaaS.                                                                              |
| **From Email**        | A verified sender address used as the "from" address. Create one integration per sender.                                              |

## Connect

Click **Connect** to validate the connection and finish. SendGrid then appears under **Environment → Integrations**. New to integrations? See the [Integrations overview](/documentation/integrations/overview).