---
title: SendGrid
description: Learn how to integrate Anedot with SendGrid Marketing Campaigns. Step-by-step guide to syncing donor data, adding contacts to lists, and managing relays.
---

[Skip to content](https://help.anedot.com/knowledge/sendgrid#main-content)

[![anedot-logo](https://help.anedot.com/hubfs/anedot-logo.svg)](https://help.anedot.com/knowledge?hsLang=en)

Open main navigation

Close main navigation

- [Get Support ⤴](https://www.anedot.com/getsupport)

[Get Support ⤴](https://www.anedot.com/getsupport)

 Here to help 👋

- There are no suggestions because the search field is empty.

1. [Public Help Center](https://help.anedot.com/knowledge?hsLang=en)
2. [Integrations](https://help.anedot.com/knowledge/integrations?hsLang=en)
3. [Email Marketing & Communication Tools](https://help.anedot.com/knowledge/integrations?hsLang=en#email-marketing-communication-tools)

# SendGrid

## Learn how to integrate Anedot with SendGrid Marketing Campaigns. Step-by-step guide to syncing donor data, adding contacts to lists, and managing relays.

**SendGrid**—also known as **Twilio SendGrid**—is a customer communication platform that provides powerful tools for **transactional and marketing email**. Anedot integrates directly with **SendGrid Marketing Campaigns** to help you grow your contact lists based on donor activity.

When connected, Anedot can automatically send **donor information** from donations to SendGrid as **marketing contacts**. You can optionally subscribe those contacts to specific marketing lists using List IDs.

---

### Table of Contents

- [Connecting Anedot to SendGrid](https://help.anedot.com/knowledge/sendgrid#connect)
- [SendGrid List IDs: Where to Find Them](https://help.anedot.com/knowledge/sendgrid#where)
- [Data Relays](https://help.anedot.com/knowledge/sendgrid#data)
- [Viewing Contacts in SendGrid](https://help.anedot.com/knowledge/sendgrid#viewing-contacts)
- [Field Mapping](https://help.anedot.com/knowledge/sendgrid#field)
- [Payload Data](https://help.anedot.com/knowledge/sendgrid#payload)

---

### Connecting Anedot to SendGrid

1. In your Anedot account, go to **Settings \> Integrations \> Directory**.
2. Click the blue **+ New Connection** button.
3. Select **SendGrid**.
4. **Select Action Pages**: Choose which pages to sync *(default: all Action Pages)*.
   
     - - To exclude pages, enter a **comma-separated list of Action Page IDs**.
5. *Optionally*, scope the integration to a specific **Team**.
6. Enter Your **SendGrid API Key**.
   
     1. Generate an API key in SendGrid with **Marketing Campaigns permissions** only.
        
            1. You may disable all other permissions.
            2. Once the API key is displayed, **copy it** and **paste it** into the Anedot integration form.
7. *Optionally*, Add **List IDs**.
   
     - Click the **Add** button to include [**SendGrid List IDs**](https://help.anedot.com/knowledge/sendgrid#where).
     - These control which marketing lists donors are automatically subscribed to.
     - You can include multiple List IDs—or none at all *(contacts will be added without list subscriptions)*.
8. Click **Save** to complete setup.

*You can edit your Action Pages, Team filters, List IDs, or API credentials at any time.*

---

### SendGrid List IDs: Where to Find Them

To get a List ID in SendGrid:

1. Go to **Marketing \> Contacts \> Lists**.
2. Click the list you want.
3. The **List ID** is the last part of the URL in your browser.

---

### Data Relays

- **Pages Supported**:  
  We send relays for both **financial and non-financial** Action Pages.
- **What’s Included**:  
  Donor contact data only.  
  **Custom fields are not currently relayed.**
- **Unsent Relay Tools**:  
  Use the **Push Unsent** feature to retry failed or unsent relays with a selected date range.
- **Failure Handling**:  
  After **five failed relay attempts**, the integration will be marked **inactive**, and no further relays will occur until reactivated.

---

### Viewing Contacts in SendGrid

To find relayed donor data:

- Go to **Marketing \> Contacts**.
- You’ll see contacts in two places:
  
    - **All Contacts**: A full list of all relayed contacts.
    - **Contact Lists**: Shows only those added to specific lists via List IDs in your integration settings.

---

### Field Mapping<https://anedot.help/integrations/sendgrid?hsLang=en#field-mapping>

The Anedot Fields match the Submission’s Raw Data and the Fields match the Request Body relay.

| **Anedot Field** | **SendGrid Field** |
| --- | --- |
| address {city} | city |
| email | email |
| address {country} | country |
| lastName | last\_name |
| firstName | first\_name |
| address {postalCode} | postal\_code |
| address {line1} | address\_line\_1 |
| address {line2} | address\_line\_2 |
| address {region} | state\_province\_region |
| list\_id *(SendGrid field)* | list\_ids |

---

### Payload Data

#### Request Headers

```
{ } 
```

#### Request Body

```
{  "contacts": [{    "city": "New Orleans",    "email": "admin@anedot.com",    "country": "US",    "last_name": "Dot",    "first_name": "Annie",    "postal_code": "70112",    "address_line_1": "1340 Poydras Street",    "address_line_2": "Suite 1770",    "state_province_region": "LA"  }],  "list_ids": ["Test"]}
```

#### Response Body *(Success)*

```
{  "job_id": "01f0a230-b384-4125-aad2-c29513ae11e3"}
```

#### Response Body *(Failure)*

```
{  "errors": [{    "field": null,    "message": "unauthorized"  }]}
```

#### Response Status *(Success)*

```
202
```

#### Response Status *(Failure)*

```
401
```

- [Get Started](https://help.anedot.com/knowledge/get-started?hsLang=en#main-content)

    - [Anedot 101](https://help.anedot.com/knowledge/get-started?hsLang=en#anedot-101)
    - [Apply for an Account](https://help.anedot.com/knowledge/get-started?hsLang=en#apply-for-an-account)
    - [Security](https://help.anedot.com/knowledge/get-started?hsLang=en#security)
- [Action Pages](https://help.anedot.com/knowledge/action-pages?hsLang=en#main-content)

    - [Action Page Basics](https://help.anedot.com/knowledge/action-pages?hsLang=en#action-page-basics)
    - [Page Builder](https://help.anedot.com/knowledge/action-pages?hsLang=en#page-builder)
    - [Advanced Features](https://help.anedot.com/knowledge/action-pages?hsLang=en#advanced-features)
    - [State Specific Pages](https://help.anedot.com/knowledge/action-pages?hsLang=en#state-specific-pages)
- [Finance](https://help.anedot.com/knowledge/finance?hsLang=en#main-content)

    - [Management & Reporting](https://help.anedot.com/knowledge/finance?hsLang=en#management-reporting)
    - [Internal Processing](https://help.anedot.com/knowledge/finance?hsLang=en#internal-processing)
- [Integrations](https://help.anedot.com/knowledge/integrations?hsLang=en#main-content)

    - [CRM & Donor Management Systems](https://help.anedot.com/knowledge/integrations?hsLang=en#crm-donor-management-systems)
    - [Email Marketing & Communication Tools](https://help.anedot.com/knowledge/integrations?hsLang=en#email-marketing-communication-tools)
    - [Integration & Automation Tools](https://help.anedot.com/knowledge/integrations?hsLang=en#integration-automation-tools)
    - [Political Campaign Tools](https://help.anedot.com/knowledge/integrations?hsLang=en#political-campaign-tools)
    - [E-commerce, Financial, and Membership Tools](https://help.anedot.com/knowledge/integrations?hsLang=en#e-commerce-financial-and-membership-tools)
    - [Relay Data & Troubleshooting](https://help.anedot.com/knowledge/integrations?hsLang=en#relay-data-troubleshooting)
- [Settings](https://help.anedot.com/knowledge/settings?hsLang=en#main-content)

    - [Access](https://help.anedot.com/knowledge/settings?hsLang=en#access)
    - [Configuration](https://help.anedot.com/knowledge/settings?hsLang=en#configuration)
    - [Finance](https://help.anedot.com/knowledge/settings?hsLang=en#finance)
    - [Setup](https://help.anedot.com/knowledge/settings?hsLang=en#setup)
    - [Other Actions](https://help.anedot.com/knowledge/settings?hsLang=en#other-actions)
- [Donor Support](https://help.anedot.com/knowledge/donor-support?hsLang=en#main-content)

    - [Getting Started with Your Donor Account](https://help.anedot.com/knowledge/donor-support?hsLang=en#getting-started-with-your-donor-account)
    - [Manage Your Giving](https://help.anedot.com/knowledge/donor-support?hsLang=en#manage-your-giving)
    - [Donor FAQ](https://help.anedot.com/knowledge/donor-support?hsLang=en#donor-faq)

[![Chill listening crop-3](https://help.anedot.com/hubfs/623c96e00d0d93f7d3a66f2e_Anedot_Typemark_Blue.svg "Chill listening crop-3")](https://www.anedot.com/)

<https://facebook.com/anedot> <https://x.com/anedot> <https://instagram.com/anedot> <https://www.youtube.com/@Anedot> <https://open.spotify.com/show/7fK8maOMuj87AeAotVDZRF> [mailto:help@anedot.com](mailto:help@anedot.com)

Copyright © 2025, Anedot, Inc.