# Set Up SendGrid

> SendGrid connects to Mailrith with an API key. Configure the Event Webhook so subscriber statuses stay in sync when bounces or spam complaints occur.

- Human page: https://mailrith.com/docs/setup-sendgrid
- Markdown page: https://mailrith.com/docs/setup-sendgrid.md
- Category: Campaigns & Delivery
- Reading time: 8 min read
- Last updated: 2026-07-13
- Related keywords: Set Up SendGrid, Set Up SendGrid documentation, Campaigns & Delivery, Campaigns & Delivery documentation, Mailrith documentation, Mailrith help, Before You Start, Mailrith Fields, SendGrid Setup, Event Webhook, Email Delivery Connections, Broadcasts, Sequences

## AI Agent Notes
- Use this article as step-by-step Mailrith product guidance, not as legal, financial, or deliverability advice unless the article says so.
- Preserve exact Mailrith UI labels from the steps when explaining a workflow.
- Prefer Mailrith's product term Subscribers when referring to people on an email list.

## What this guide covers
Connect SendGrid with an API key, then configure the Event Webhook to forward bounce and spam report events to Mailrith.

## Sections
- Before You Start
- Mailrith Fields
- SendGrid Setup
- Event Webhook

## Visual Reference
![Mailrith email delivery connections page showing connected services with action controls.](https://mailrith.com/docs/screenshots/email-delivery-connections.png)

The Email Delivery Connections page lists every connected service. From here you can add a connection, send a test email, view delivery-event links, and assign connections to workspaces.

## Before You Start

SendGrid connects to Mailrith with an API key. SendGrid sends delivery events to Mailrith through the SendGrid Event Webhook. Before you create the connection, prepare these items in SendGrid:

- **A verified sender or authenticated domain:** the From email in Mailrith must be allowed to send from SendGrid.
- **An API key:** create a key with permission to send mail.
- **Event Webhook access:** Mailrith needs this access to receive bounce, dropped, and spam report events from SendGrid.
- **A test inbox:** send a test email to this inbox to confirm Mailrith can send through SendGrid before you use the connection for real campaigns.

If you have not used SendGrid with your domain before, complete sender authentication first. A valid API key cannot send mail if SendGrid does not allow the From email.

## Mailrith Fields

In Mailrith, click [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in the left sidebar, click **Create Connection**, choose **SendGrid** in **Select Email Delivery Service**, and enter these fields in **Connect Email Delivery Service**:

- **Connection name:** an internal label for the connection, such as "SendGrid Marketing".
- **API Key:** the SendGrid key that has permission to send mail.
- **From name:** the sender name subscribers see in their inbox.
- **From email:** the sender address that SendGrid has approved.
- **Workspaces:** the workspaces that can send email through this connection.

## SendGrid Setup

1. Sign in to SendGrid and open the account that will send Mailrith email.
2. Confirm the sender identity before you create the Mailrith connection. For long-term sending, use SendGrid domain authentication when possible. For testing only, you can use a verified single sender, but the From email in Mailrith must match a sender that SendGrid allows.
3. If you use domain authentication, open SendGrid's sender-authentication area, start domain authentication, choose your domain, and add the DNS records from SendGrid at your DNS provider. Wait until SendGrid shows your domain as verified, then test the connection in Mailrith.
4. Open **Settings** in the SendGrid left sidebar, then open **API Keys**.
5. Click **Create API Key**.
6. Name the key clearly, such as **Mailrith sending** or **Mailrith production sender**.
7. Choose permissions for the key. Use restricted permissions if your SendGrid plan and account settings allow them, and give the key permission to send mail. Do not give broad account access unless your team has approved that access.
8. Click **Create & View** or the equivalent SendGrid action that creates the key and shows the key value.
9. Copy the API key immediately because SendGrid only shows the full key once.
10. Return to [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md) in Mailrith, click **Create Connection**, and choose **SendGrid**.
11. Paste the API key, enter the From name, enter the SendGrid-approved From email, assign workspaces, and click **Save**.
12. Use **Send Test Email** from the connection row before you use the connection in a broadcast, sequence, or automation.

If the test fails, check that the API key has permission to send mail, the sender or domain is verified in SendGrid, the SendGrid account is active, and the From email exactly matches a sender or authenticated domain that SendGrid allows.

## Event Webhook

SendGrid's Event Webhook tells Mailrith when a subscriber bounces, is dropped, or reports spam. Mailrith uses these events to update subscriber status and protect future sends.

1. In Mailrith, click **Email Delivery Connections**, click **Webhooks** on the SendGrid connection, and copy the delivery-event webhook URL exactly.
2. In SendGrid, open **Settings**, then open the **Event Webhook** settings.
3. Create a new event webhook, or edit the existing event webhook used for this sender.
4. Paste the Mailrith delivery-event URL as the endpoint URL.
5. Enable bounce, dropped, and spam report events. You can also enable delivered, deferred, opened, or clicked events if your team wants provider-side reporting, but Mailrith needs the problem events to protect subscribers.
6. Save the webhook and confirm that SendGrid shows the webhook as enabled.
7. After the next test or small send, check SendGrid's webhook activity if Mailrith does not show delivery events.

If Mailrith is not receiving events, check that the endpoint URL exactly matches the Mailrith delivery-event URL, the webhook is enabled in SendGrid, and the selected SendGrid events include bounce, dropped, and spam report events.

## Related Guides
- [Email Delivery Connections](https://mailrith.com/docs/email-delivery-connections.md): You connect your own email delivery service. Mailrith then manages subscribers, campaigns, follow-up, and reports while that service sends the emails.
- [Broadcasts](https://mailrith.com/docs/broadcasts.md): Use broadcasts for newsletters, product launches, announcements, and any message you send once to selected subscribers. Compose, target, test, and send or schedule the campaign in one workflow.
- [Sequences](https://mailrith.com/docs/sequences.md): Sequences send a series of emails over time as subscribers move through the steps. Use sequences for onboarding, nurture campaigns, and educational content that should be sent over days or weeks.