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

# SendGrid

> This page outlines how to use the SendGrid integration for transactional email in Cargo.

SendGrid is a cloud-based email delivery platform that helps businesses send transactional and marketing emails at scale. Cargo's native integration with SendGrid allows you to send templated emails directly from your workflows.

## How to set up SendGrid

To connect SendGrid, you'll need an API key from your SendGrid account.

### Connection details

| Field       | Description           |
| ----------- | --------------------- |
| **API Key** | Your SendGrid API key |

<Tip>Create an API key in SendGrid under **Settings → API Keys**. Ensure it has permission to send emails.</Tip>

Once the connector is created, you can:

* **Use SendGrid in workflows** — Choose **SendGrid** from the node catalog within a **Play**, **Tool**, or **Agent**.

***

## SendGrid actions

### Send email

Send an email using SendGrid's dynamic template system.

**Use cases**

* **Transactional emails** – Send order confirmations, receipts, notifications
* **Personalized outreach** – Send customized emails with dynamic content
* **Automated follow-ups** – Trigger emails based on workflow conditions

**Configuration**

| Field            | Description                            |
| ---------------- | -------------------------------------- |
| **Template**     | Select from your SendGrid templates    |
| **Subject**      | Email subject line                     |
| **From email**   | Sender email address                   |
| **From name**    | Sender display name                    |
| **To email**     | Recipient email address                |
| **Dynamic data** | Key-value pairs for template variables |

<Info>Templates are created and managed in SendGrid. Use dynamic data to populate template variables like `{{first_name}}` or `{{company}}`.</Info>

***

## Dynamic template data

SendGrid templates support dynamic variables that you can populate from your workflow data.

### Example configuration

| Key           | Value                   |
| ------------- | ----------------------- |
| `first_name`  | `{{contact.firstName}}` |
| `company`     | `{{contact.company}}`   |
| `meeting_url` | `{{calendar.link}}`     |

<Warning>Ensure your template variables match the keys you provide in dynamic data. Mismatched keys will result in empty values.</Warning>