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

# SendGrid Integration

> Connect your SendGrid account to SendPost for unified email management, advanced analytics, and enhanced deliverability monitoring.

SendPost's SendGrid integration allows you to use your existing SendGrid account as a **Third-Party Sending Provider (TPSP)**. This means you can:

* Send emails through SendGrid while using SendPost's unified API
* Receive and process SendGrid events (opens, clicks, bounces, etc.) in SendPost
* View all email analytics in one centralized dashboard
* Apply SendPost's intelligent routing and throttling to your SendGrid traffic

Additionally, SendPost offers a **SendGrid-Compatible API** that allows you to migrate from SendGrid with minimal code changes.

***

## Why Use SendGrid with SendPost?

| Feature                  | SendGrid Alone | SendGrid + SendPost                               |
| ------------------------ | -------------- | ------------------------------------------------- |
| Multiple ESP management  | ❌              | ✅ Unified dashboard for all providers             |
| Cross-provider analytics | ❌              | ✅ Compare performance across ESPs                 |
| Advanced throttling      | Basic          | ✅ Per-provider rate limiting (Gmail, Yahoo, etc.) |
| Failover routing         | ❌              | ✅ Automatic fallback to other providers           |
| Centralized event logs   | ❌              | ✅ All events in one place                         |
| Sub-account management   | Limited        | ✅ Flexible sub-account hierarchy                  |

***

## What's Covered in This Guide

<CardGroup cols={2}>
  <Card title="Setting Up" icon="gear" href="/guides/sendgrid/setup">
    Configure SendGrid as a provider in SendPost with automatic webhook setup
  </Card>

  <Card title="Sending Emails" icon="paper-plane" href="/guides/sendgrid/sending-emails">
    Send emails through SendGrid using the SendPost API with IP Pool routing
  </Card>

  <Card title="Compatible API" icon="code" href="/guides/sendgrid/compatible-api">
    Migrate from SendGrid with minimal code changes using our compatible API
  </Card>

  <Card title="Event Types" icon="bell" href="/guides/sendgrid/event-types">
    Understand SendGrid event types and how they map to SendPost
  </Card>

  <Card title="Analytics" icon="chart-line" href="/guides/sendgrid/analytics">
    Track opens, clicks, bounces and configure rate limiting
  </Card>

  <Card title="Troubleshooting" icon="wrench" href="/guides/sendgrid/troubleshooting">
    Common issues, FAQs, and getting help
  </Card>
</CardGroup>

***

## Quick Reference

### Key Endpoints

| Purpose                          | URL                              |
| -------------------------------- | -------------------------------- |
| Send Email (Native)              | `POST /api/v1/subaccount/email/` |
| Send Email (SendGrid Compatible) | `POST /v1/sendgrid/v3/mail/send` |
| View Events                      | SendPost Dashboard → Events      |

### Setup Checklist

<Steps>
  <Step title="Create SendGrid API Key">
    Create API key with Mail Send + Event Webhook permissions
  </Step>

  <Step title="Add Provider">
    Add SendGrid provider in SendPost dashboard
  </Step>

  <Step title="Configure IP Pool">
    Create an IP Pool in SendPost configured to route traffic to SendGrid
  </Step>

  <Step title="Whitelist Domain">
    Whitelist your sending domain in SendPost (same domain used in SendGrid)
  </Step>

  <Step title="Test">
    Send a test email with the `ippool` parameter
  </Step>

  <Step title="Confirm Events">
    Confirm events appear in SendPost analytics
  </Step>
</Steps>