SendGrid Connector
Connector status: In progress Being built. Not verified yet.
Illustration · sample data
Sync example
Source
SendGrid
Connector status: In progress
Destination
Your other tool
Connector status: Custom tool
Field mapping
| 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 |
- Draft
- Review one record
- Approve this version
Statuses describe individual connectors; they do not guarantee this sync is ready. Illustrative fields. Review the actual schema and permissions before a sync runs.
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 | fb95a93 | JSON (47), YAML (47), Markdown (5), YAML (1), gitignore (1), license (1) | 103 |
Integration Shape
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.