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

# SendGrid

## Overview

> [card] [Pre-built tooling](#pre-built-tooling)

> [card] [Pre-built integrations](#pre-built-integrations)

> [card] [Access requirements](#access-requirements)

> [card] [Setup guide](#setup-guide)

> [card] [Useful links](#useful-links)

> [card] [API gotchas](#api-gotchas)

## Pre-built tooling

> [accordion] ✅ Authorization
>
> | Tools | Status |
> | - | - |
> | Pre-built authorization (API Key) | ✅ |
> | Pre-built authorization UI | ✅ |
> | Custom authorization UI | ✅ |
> | End-user authorization guide | ✅ |
> | Expired credentials detection | ✅ |

> [accordion] ✅ Read & write data
>
> | Tools | Status |
> | - | - |
> | Pre-built integrations | ✅ |
> | API unification | ✅ |
> | 2-way sync | ✅ |
> | Webhooks from Nango on data modifications | ✅ |
> | Real-time webhooks from 3rd-party API | 🚫 (time to contribute: \<48h) |
> | Proxy requests | ✅ |

> [accordion] ✅ Observability & data quality
>
> | Tools | Status |
> | - | - |
> | HTTP request logging | ✅ |
> | End-to-end type safety | ✅ |
> | Data runtime validation | ✅ |
> | OpenTelemetry export | ✅ |
> | Slack alerts on errors | ✅ |
> | Integration status API | ✅ |

> [accordion] ✅ Customization
>
> | Tools | Status |
> | - | - |
> | Create or customize use-cases | ✅ |
> | Pre-configured pagination | 🚫 (time to contribute: \<48h) |
> | Pre-configured rate-limit handling | 🚫 (time to contribute: \<48h) |
> | Per-customer configurations | ✅ |

### Others

| Function name | Description | Type |
| - | - | - |
| `activate-template-version` | Mark a template version as the active one used when sending. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-contacts-to-list` | Add existing contacts to a list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-global-suppressions` | Add email addresses to the global suppression (unsubscribe) list | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `add-group-suppressions` | Unsubscribe email addresses from a specific group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-custom-field` | Create a custom contact field definition. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-dynamic-template` | Create a dynamic template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-list` | Create a contact list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-segment` | Create a segment from a SQL query over contacts. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-sender-identity` | Create a sender identity (triggers a verification email). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-suppression-group` | Create an unsubscribe group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `create-template-version` | Create a new version of a dynamic template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-blocks` | Clear block suppressions for one or more addresses, or all of them. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-bounces` | Clear bounce suppressions for one or more addresses, or all of them. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-contacts` | Delete contacts by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-custom-field` | Delete a custom contact field definition. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-dynamic-template` | Delete a dynamic template and all of its versions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-global-suppression` | Remove a single email address from the global suppression list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-group-suppression` | Remove a single email address's unsubscribe from a specific group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-invalid-emails` | Clear invalid-email suppressions for one or more addresses, or all of them. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-list` | Delete a contact list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-segment` | Delete a segment. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-sender-identity` | Delete a sender identity. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-spam-reports` | Clear spam-report suppressions for one or more addresses, or all of them. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-suppression-group` | Delete an unsubscribe group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `delete-template-version` | Delete a template version. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-contacts-count` | Get total and billable contact counts. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-dynamic-template` | Get a single dynamic template and all of its versions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-list` | Get a single contact list by id. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-segment` | Get a single segment by id, including a contact sample. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `get-stats` | Get email statistics. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-blocks` | List blocked email addresses. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-bounces` | List bounced email addresses. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-contacts` | List marketing contacts (small, capped result set). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-custom-fields` | List custom contact field definitions. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-dynamic-templates` | List dynamic templates. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-global-suppressions` | List globally unsubscribed email addresses. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-group-suppressions` | List the email addresses unsubscribed from a specific group. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-invalid-emails` | List invalid email addresses. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-lists` | List contact lists. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-segments` | List segments (Segmentation v2). | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-sender-identities` | List verified sender identities. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-spam-reports` | List email addresses that reported spam. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `list-suppression-groups` | List unsubscribe groups. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `remove-contacts-from-list` | Remove contacts from a list. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `resend-sender-verification` | Resend the verification email for a sender identity. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `search-contacts` | Search marketing contacts with a SQL-like query. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `send-mail` | Send an email. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-dynamic-template` | Rename a dynamic template. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-segment` | Update a segment's name or query. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-sender-identity` | Update a sender identity's details. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-suppression-group` | Update an unsubscribe group's name or description. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `update-template-version` | Update a template version's content. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `upsert-contacts` | Create or update marketing contacts, optionally adding them to lists. | [Tool](https://nango.dev/docs/guides/functions/tools.md) |
| `bounces` | Sync bounced email events. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `contacts` | Sync a sample of contacts. SendGrid does not offer a paginated or full-export-capable contacts listing endpoint usable here, so this sync only reflects the small recent-contacts sample the API returns and never deletes previously synced records. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `global-suppressions` | Sync globally unsubscribed email addresses. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `lists` | Sync lists. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `segments` | Sync segments. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `sender-identities` | Sync verified sender identities. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `stats` | Sync daily email statistics. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |
| `templates` | Sync dynamic templates and their versions. | [Sync](https://nango.dev/docs/guides/functions/syncs/sync-functions.md) |

## Access requirements

| Pre-Requisites | Status | Comment |
| - | - | - |
| Paid dev account | ❓ | |
| Paid test account | ❓ | |
| Partnership | ❓ | |
| App review | ❓ | |
| Security audit | ❓ | |

## Setup guide

*No setup guide yet.*

> [!TIP]
>
> Need help getting started? Get help in the [community](https://nango.dev/slack).

> [!NOTE]
>
> Contribute improvements to the setup guide by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sendgrid.mdx)

## Useful links

* [Generate an API key in your SendGrid account](https://app.sendgrid.com/settings/api_keys)
* [API docs](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/authentication)
* [Auth-related docs](https://docs.sendgrid.com/api-reference/how-to-use-the-sendgrid-v3-api/authentication#authorization-header)

> [!NOTE]
>
> Contribute useful links by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sendgrid.mdx)

## API gotchas

> [!NOTE]
>
> Contribute API gotchas by [editing this page](https://github.com/nangohq/nango/tree/master/docs/integrations/all/sendgrid.mdx)

## Going further

> [card] [Connect to SendGrid](https://nango.dev/docs/integrations/all/sendgrid/connect)
>
> Guide to connect to SendGrid using Nango Connect UI.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.