---
title: "SendGrid Connector | Tajo"
description: "Tajo's SendGrid connector is in progress: it sends email through your own SendGrid account and reads suppressions and contacts. Not yet verified on a live account."
url: https://tajo.io/docs/connectors/marketing/sendgrid/
markdown: https://tajo.io/docs/connectors/marketing/sendgrid.md
lang: en-US
author: "Set Noa"
author_url: https://tajo.io/set-noa/
robots: noindex
---

# SendGrid Connector

[Set Noa](https://tajo.io/set-noa/)

Connector status: In progress Being built. Not verified yet.

| Source field | Destination field | Sample value |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Tajo’s SendGrid connector is in progress. The code exists, but it has not yet passed a run against a live SendGrid account.

## What the code does

- Sends one email through your own SendGrid account; SendGrid bills that message to you.
- Receives SendGrid’s signed Event Webhook: delivered, bounce, dropped, spam report, unsubscribe, open and click.
- Adds an address to the global unsubscribe list, and reads unsubscribes, bounces and spam reports.
- Reads marketing contacts, lists and Single Sends.

## Not available today

- Migration of contacts, templates or statistics into Brevo
- Sender identity and domain authentication sync

## Open-Source Implementation Map

This section is derived from official or public repository material discovered for the SendGrid connector. Use it as the engineering companion to the setup guide above: it shows where the API surface lives, what implementation assets exist, and how Tajo should translate them into reliable Brevo sync behavior.

### Repository Snapshot

| Repository | Commit | Languages / formats | Files |
| --- | --- | --- | --- |
| [twilio/sendgrid-oai](https://github.com/twilio/sendgrid-oai) | fb95a93 | JSON (47), YAML (47), Markdown (5), YAML (1), gitignore (1), license (1) | 103 |

### Integration Shape

```mermaid
graph LR
  Source["SendGrid API / repository"] --> Auth["Auth and scopes"]
  Source --> Objects["Objects, events, and schemas"]
  Auth --> Tajo["Tajo connector runtime"]
  Objects --> Tajo
  Tajo --> Brevo["Brevo contacts, attributes, lists, campaigns"]
  Tajo --> Ops["Backfill, cursor, retries, logs"]
```

### What To Reuse

- Sendgrid’s OpenAPI Specification
- This repository contains OpenAPI documents
- The SendGrid OAI specifications are automatically generated from the SendGrid OAS specifications using the ‘sendgrid-oas-transpiler’.
- The ‘sendgrid-oai’ is utilized to auto-generate SendGrid helper libraries through the ‘sendgrid-oai-generator’.
- Currently, only the ‘sendgrid-java’ helper library is available for auto-generation.

### Tajo Revamp Checklist

- Keep authentication setup aligned with the vendor docs and the public repository’s current API shape.
- Map primary resources into explicit Tajo sync objects with stable external IDs.
- Prefer cursor-based or updated-at incremental sync where the API exposes it; otherwise document the fallback.
- Treat webhook handlers as idempotent and replay-safe, especially for order, contact, ticket, and campaign events.
- Capture pagination, rate limits, retry headers, and partial-failure behavior in connector smoke tests.
- Keep examples small and runnable against sandbox or test-mode accounts.

### Sources

- [twilio/sendgrid-oai](https://github.com/twilio/sendgrid-oai)
- [Vendor documentation](https://www.twilio.com/docs/sendgrid/api-reference)