SendGrid mail and contacts API contracts.
Scope
Primary execution surface: server.
Developer Source Map
RudderStack Cross-Check
RudderStack is used here only as secondary engineering evidence for discovery and cross-check.
| Destination | Type | Link |
|---|
sendgrid | Discovery lead | source |
Verified Contracts
Event Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
event | event_contract | server | object | Conditional | Platform event contract surface is documented on the referenced developer page. | Not clearly specified | Not clearly specified | - | Verified against vendor-owned developer documentation for this contract category. | docs.sendgrid.com | Verified | High |
User Data Contracts
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
user | user_data_contract | server | object | Conditional | Platform user/profile identifier contract surface is documented on the referenced developer page. | Not clearly specified | Not clearly specified | - | Verified against vendor-owned developer documentation for this contract category. | docs.sendgrid.com | Verified | High |
Transport / Payload Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
request | endpoint | server | object | Required | SendGrid v3 endpoints require Bearer API key authentication and JSON payloads. | Not clearly specified | Not clearly specified | - | Verified against vendor-owned developer documentation for this contract category. | docs.sendgrid.com | Verified | High |
Candidate / Needs Review Items
Normalization Rules
| Object / Event | Field | Applies To | Type | Requirement | Exact Format | Normalization | Hashing | Examples | Caveat | Primary Source | Status | Confidence |
|---|
normalization | hashing_contract | server | string | Optional | No explicit field-level hashing contract is documented for the scoped rows. | Not clearly specified | Not clearly specified | - | Blocker: hashing_contract_missing — No explicit hashing contract for scoped rows. | docs.sendgrid.com | Needs manual review | Medium |
normalization | normalization_contract | server | string | Optional | Not clearly specified in one canonical row-level contract; see blocker/caveat. | Not clearly specified | Not clearly specified | - | Blocker: normalization_contract_missing — Canonical normalization rules for mapped fields not explicit in current extracted docs. | docs.sendgrid.com | Needs manual review | Medium |
Excluded Items
No excluded rows in this revision.
Last Reviewed
2026-03-31