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

# SendGrid

> Route Rootly workflow emails through your own SendGrid account to send from your company domain with full delivery visibility, tracking, and authentication.

## Overview

By default, Rootly sends workflow emails from `workflows@rootly.com`. Connecting SendGrid lets you route those emails through your own SendGrid account instead — so emails arrive from your company domain and you retain full delivery analytics in SendGrid.

<CardGroup cols={2}>
  <Card title="Custom Sender Domain" icon="at">
    Send workflow emails from your own domain instead of Rootly's default address.
  </Card>

  <Card title="Delivery Analytics" icon="chart-line">
    Track opens, clicks, bounces, and delivery status directly in your SendGrid dashboard.
  </Card>

  <Card title="Works with Send Email Action" icon="paper-plane">
    All **Send an Email** workflow actions automatically route through SendGrid once connected — no changes needed to existing workflows.
  </Card>

  <Card title="API Key Validation" icon="key">
    Rootly validates your API key against the SendGrid API on connect, so misconfigurations are caught immediately.
  </Card>
</CardGroup>

## Before You Begin

* You must be a Rootly admin to set up the integration
* You need a SendGrid account with permission to create API keys

## Installation

<Steps>
  <Step title="Create a SendGrid API key">
    In SendGrid, go to **Settings → API Keys** and create a new key. Select **Restricted Access** and enable **Full Access** for **Mail Send** only — no other scopes are needed.

    <Frame>
      <img alt="SendGrid API key permissions with Mail Send set to Full Access" src="https://mintcdn.com/rootly/6qP0tS1GNk4jbxrs/images/integrations/sendgrid/images-1.webp?fit=max&auto=format&n=6qP0tS1GNk4jbxrs&q=85&s=c5f89fe04fb1a893333a6e76920cc12b" width="862" height="820" data-path="images/integrations/sendgrid/images-1.webp" />
    </Frame>

    Copy the API key — you won't be able to view it again after leaving the page.
  </Step>

  <Step title="Connect in Rootly">
    In Rootly, go to **Configuration → Integrations**, find **SendGrid**, and click **Setup**. Enter your API key and optionally set a **Default From** address.

    Rootly validates the key against the SendGrid API before saving. If the `mail.send` scope is missing, the connection will be rejected.
  </Step>
</Steps>

## Configuration

<ParamField body="API Key" type="string" required>
  Your SendGrid API key. Must have the `mail.send` scope. Stored encrypted at rest.
</ParamField>

<ParamField body="Default From" type="string">
  The sender email address used when no `From` is specified in a workflow action — for example, `incidents@yourcompany.com`. If left blank, the `From` field in each workflow action determines the sender.
</ParamField>

<Note>
  Once SendGrid is connected, all **Send an Email** workflow actions are automatically routed through it. The **From** field in the workflow action still controls the sender address per-email — the **Default From** here serves as a fallback.
</Note>

## Uninstall

To remove the SendGrid integration:

1. Go to **Configuration → Integrations** and find **SendGrid**
2. Click **Connected** to reveal the disconnect option
3. Click **Disconnect**

<Frame>
  <img src="https://mintcdn.com/rootly/QMD-dNqeYW4BA9dg/images/integrations/common/uninstall-connected.png?fit=max&auto=format&n=QMD-dNqeYW4BA9dg&q=85&s=dbb790e2576c8969bba96bc26c95265f" alt="Click Connected to reveal the Disconnect option" width="319" height="188" data-path="images/integrations/common/uninstall-connected.png" />
</Frame>

After disconnecting, workflow emails will revert to Rootly's default delivery.

## Frequently Asked Questions

<AccordionGroup>
  <Accordion title="Do I need to change my existing workflows after connecting SendGrid?" icon="rotate">
    No. All **Send an Email** workflow actions automatically route through SendGrid once the integration is connected. No changes to existing workflows are required.
  </Accordion>

  <Accordion title="What's the minimum permission needed for the API key?" icon="key">
    Only `mail.send` (Full Access) is required. Rootly validates this on connect — if the scope is missing, the key will be rejected.
  </Accordion>

  <Accordion title="Can I use SendGrid and SMTP at the same time?" icon="shuffle">
    No. If both a SendGrid and an SMTP integration are connected, Rootly prefers SMTP. To use SendGrid, disconnect the SMTP integration first.
  </Accordion>

  <Accordion title="Will disconnecting SendGrid affect emails already sent?" icon="plug-circle-xmark">
    No. Emails already delivered are unaffected. After disconnecting, new workflow emails will revert to Rootly's default delivery method.
  </Accordion>
</AccordionGroup>