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

# SendGrid

> Send transactional emails with dynamic templates, manage contacts and lists, and track delivery events.

# SendGrid

Send transactional emails, manage contact lists, and react to delivery events — opens, clicks, bounces, unsubscribes, and spam reports — from your Collabase automations.

## Authentication

**Auth type:** API Key

Create an API key at [app.sendgrid.com/settings/api\_keys](https://app.sendgrid.com/settings/api_keys) with **Mail Send** and **Marketing** permissions.

| Credential  | Description                               |
| ----------- | ----------------------------------------- |
| **API Key** | Your SendGrid API key (starts with `SG.`) |

## Triggers

| Trigger             | When it fires                                    |
| ------------------- | ------------------------------------------------ |
| **Email Delivered** | A message is delivered to the recipient's server |
| **Email Opened**    | A recipient opens a tracked email                |
| **Email Clicked**   | A recipient clicks a tracked link                |
| **Email Bounced**   | Delivery fails with a hard or soft bounce        |
| **Unsubscribed**    | A recipient unsubscribes from your list          |
| **Spam Report**     | A recipient marks the email as spam              |

## Actions

| Action                       | Key inputs                                                                             | Key outputs                                 |
| ---------------------------- | -------------------------------------------------------------------------------------- | ------------------------------------------- |
| **Send Email**               | `to`, `toName`, `from`, `fromName`, `subject`, `htmlContent`, `textContent`, `replyTo` | messageId, status                           |
| **Send Template Email**      | `to`, `from`, `templateId`, `dynamicTemplateData{}`                                    | messageId                                   |
| **Add Contact**              | `email`, `firstName`, `lastName`, `listIds[]`                                          | contactId                                   |
| **Add Contact to List**      | `email`, `listId`                                                                      | success                                     |
| **Get Lists**                | —                                                                                      | lists\[] — id, name, contactCount           |
| **Remove from Suppressions** | `email`, `groupId` (optional)                                                          | success                                     |
| **Get Email Stats**          | `startDate`, `endDate`                                                                 | requests, delivered, opens, clicks, bounces |

<Tip>
  Use **Send Template Email** for branded layouts. Design your template in SendGrid with `{{variable}}` placeholders, then pass matching keys via `dynamicTemplateData`.
</Tip>