SendGrid
Send the right update through SendGrid at the right moment, with a person approving what reaches customers.
45 ways to read, 16 ways to write, each write switched on by you.
Quality checks
Built and tested with example responses.
- Ready to connect: doneEvery listed action is built in.
- Built and tested with example responses: doneEach action is built from the provider’s published API and tested against example responses, errors, rate limits and paging.
Connected, approved, proven.
The things teams do most with SendGrid, an example flow with a person in the loop, and what Nexra keeps as proof.
Top actions
- Add or update contactApproval by rule
- Create designApproval by rule
- List spam reportsRead
Example flow
- HubSpot · Read contactsDone
- SendGrid · Send emailNeeds approval
- Nexra · Record the decision and result in the evidence chainProven
Example workflow. Routine runs go through on their own. Only a change your rules flag, such as one over a limit you set, waits for the right person, who sees the exact change and the rule before it reaches SendGrid.
What gets logged
- Whether it ran on its own or who approved it, and under which rule
- A fingerprint of the exact request sent to SendGrid
- SendGrid's reply: what it created or changed
- One entry in the evidence chain, linked to the one before
Try this in the sandbox
Run the whole flow with test data in your sandbox, then connect your own account when you are ready to go live.
For developers
Technical detail
Send transactional email with SendGrid; manage contacts, lists, segments, fields, Single Send and template drafts, designs and unsubscribe groups; read suppressions, activity and stats.
Twilio API docs- Source actions
- 45
- Destination actions
- 16
- Data types
- 36
What you can map
Reads are always available. Writes are off until you switch them on for a connection, and governed writes follow your policies.
Account1
- Get accountSource
Account type and sender reputation.
Authenticated domains1
- List authenticated domainsSource
Sender authentication (DKIM/SPF) domains and their validity.
Automation stats1
- List automation statsSource
Delivery and engagement totals for Marketing Campaigns automations. Read-only.
Blocks1
- List blocksSourceIncremental
Addresses whose receiving server blocked a message.
Bounces1
- List bouncesSourceIncremental
Addresses suppressed after a bounce.
Categories1
- List categoriesSource
Mail send categories used for statistics, optionally by prefix.
Category stats1
- List category statsSource
Daily, weekly or monthly email statistics for up to 10 categories.
Contact counts1
- Count contactsSource
Total and billable Marketing Campaigns contact counts.
Contact emails1
- Find contacts by emailSource
Contacts for up to 100 email addresses, matching primary or alternate emails.
Contact identifiers1
- Find contacts by identifierSource
Up to 100 contacts by exact email, phone number ID, external ID or anonymous ID, sent in the request body.
Contact IDs1
- Get contacts by IDsSource
Up to 100 contacts by contact ID in one request.
Contact imports1
- Get contact import jobSource
Status and counts for an asynchronous contact upsert job.
Contacts4
- Get contactSource
One contact with list and segment memberships and custom field values.
- List recent contactsSource
A sample of up to 50 of the most recently added Marketing Campaigns contacts.
- Search contactsSource
Contacts matching an email prefix, name or list, built into a SendGrid SGQL query (first 50 matches).
- Add or update contactDestinationProvider duplicate protectionApproval before production
Adds or updates one Marketing Campaigns contact by email and optionally adds it to lists. Runs as an asynchronous SendGrid job.
Designs4
- Create designDestinationNot retried automaticallyApproval before production
Adds an HTML design to the design library. Designs are content only and are never sent.
- Get designSource
One design with its HTML and plain-text content.
- List designsSource
Marketing email designs in the design library.
- Update designDestinationProvider duplicate protectionApproval before production
Updates a design's name, subject, categories or content. Nothing is sent.
Event webhooks1
- List event webhooksSource
Event Webhook endpoints with the event types each receives.
Field definitions3
- Create custom fieldDestinationProvider duplicate protectionApproval before production
Creates a custom contact field.
- List contact fieldsSource
Custom and reserved contact field definitions with their types.
- Rename custom fieldDestinationProvider duplicate protectionApproval before production
Renames a custom field definition. Its type cannot change.
Global unsubscribes1
- List global unsubscribesSourceIncremental
Addresses that unsubscribed from all email from this account (consent withdrawn).
Group suppressions1
- Check group unsubscribesSource
Which of up to 100 addresses have unsubscribed from one group; addresses go in the request body.
Group unsubscribes1
- List group unsubscribesSource
Addresses that opted out of one unsubscribe group.
Invalid emails1
- List invalid emailsSourceIncremental
Addresses SendGrid rejected as invalid.
List contact counts1
- Count list contactsSource
Number of contacts on one list.
Lists4
- Create contact listDestinationNot retried automaticallyApproval before production
Creates a Marketing Campaigns list.
- Get contact listSource
One list with its contact count.
- List contact listsSource
Marketing Campaigns lists with contact counts.
- Rename contact listDestinationProvider duplicate protectionApproval before production
Changes a list's name.
Mail1
- Send emailDestinationNot retried automaticallyApproval before production
Sends one transactional email (up to 50 recipients), with raw content or a dynamic template.
Messages1
- Search email activitySource
Recent messages with delivery status, opens and clicks, filtered by recipient, sender, subject or status.
Segments4
- Create segmentDestinationNot retried automaticallyApproval before production
Creates a segment from an SGQL query, optionally within one parent list.
- Get segmentSource
One segment with its SGQL query and validation status.
- List segmentsSource
Marketing Campaigns segments with contact counts, optionally for parent lists.
- Update segmentDestinationProvider duplicate protectionApproval before production
Renames a segment or changes its SGQL query.
Senders1
- List marketing sendersSource
Marketing Campaigns sender identities with verification status.
Single send stats2
- Get Single Send statsSource
Stats for one Single Send, in total or by day.
- List Single Send statsSource
Delivery and engagement totals for all or selected Single Sends.
Single sends5
- Create Single Send draftDestinationNot retried automaticallyApproval before production
Creates a Single Send as an unscheduled draft. Nothing is sent or scheduled; schedule it in SendGrid.
- Get Single SendSource
One Single Send with recipients and email settings.
- List Single SendsSource
Marketing Single Sends (campaigns) with status and schedule. Read-only.
- Search Single SendsSource
Single Sends by name, status or category.
- Update Single Send draftDestinationProvider duplicate protectionApproval before production
Updates a Single Send's name, recipients or content. SendGrid documents this as a draft update; it never schedules or sends.
Spam reports1
- List spam reportsSourceIncremental
Addresses that marked a message as spam.
Stats1
- Get email statisticsSource
Global delivery and engagement totals per day, week or month.
Subusers1
- List subusersSource
Subusers of this account with region and status.
Teammates1
- List teammatesSource
Teammates with their user type and admin flag.
Template versions2
- Create template version draftDestinationNot retried automaticallyApproval before production
Adds an inactive (draft) version to a transactional template. Sends keep using the active version.
- Get template versionSource
One version of a transactional template with its content.
Templates3
- Create dynamic templateDestinationNot retried automaticallyApproval before production
Creates an empty dynamic transactional template; add content with template_versions.create.
- Get templateSource
One transactional template with its versions.
- List templatesSource
Dynamic (and optionally legacy) transactional templates with their versions.
Unsubscribe groups4
- Create unsubscribe groupDestinationProvider duplicate protectionApproval before production
Creates an unsubscribe group recipients can opt out of. Does not add anyone to it.
- Get unsubscribe groupSource
One unsubscribe (suppression) group with its unsubscribe count.
- List unsubscribe groupsSource
Suppression (ASM) groups recipients can opt out of individually.
- Update unsubscribe groupDestinationProvider duplicate protectionApproval before production
Renames or redescribes an unsubscribe group. Its suppressions are unchanged.
Verified senders1
- List verified sendersSource
Single Sender Verification identities used as From addresses.
Access and limits
- Authentication
- API key
- Plans and access
- All SendGrid plans. Marketing Campaigns contacts need a Marketing Campaigns plan (Free or paid); email activity needs the Email Activity History add-on; the EU region needs a Pro plan or above. API keys can be limited to scopes; grant Mail Send, Marketing, Design Library, Templates, Suppressions (read, plus group create/update), Stats, Categories, Sender Verification, Webhooks (read), Subusers (read), Teammates (read) and Email Activity (read) as needed.
- Test environment
- Use a free account and the sandbox mode mail setting to validate sends without delivery.
- Rate limits
- Per-endpoint limits reported in X-RateLimit-Limit/Remaining/Reset headers; HTTP 429 when exceeded. Contact search has its own low limit and email activity allows few requests per minute.
- Pagination
- page_token from _metadata.next on lists, templates, Single Sends, designs and Marketing stats; limit/offset on suppressions, categories, domains, subusers and teammates; lastSeenID on verified senders; contact samples and searches return at most 50 records.
- Provider events
- Event Webhook for delivery, open, click, bounce, spam report and unsubscribe events. Flows run on demand, on a schedule, or when a scheduled check finds new or changed records.
Before you build a flow
- Contact reads return at most 50 contacts (SendGrid's sample and SGQL search limits); full exports are asynchronous and not implemented.
- SendGrid contacts carry no consent field: opt-outs live in global unsubscribes and unsubscribe-group suppressions, which Nexra reads but never changes.
- Contact upsert is asynchronous; read the returned job with contact_imports.get to learn the outcome.
- Mail send has no idempotency key and repeated requests send again; uncertain sends are not repeated automatically. Recipients are limited to 50 in one personalization so the operation cannot broadcast to audiences.
- Scheduling, sending, test-sending or duplicating Single Sends, automation changes, template version activation and edits, legacy campaigns, suppression and global unsubscribe changes, group suppression adds, contact imports and exports, sender, domain, webhook, subuser and teammate changes, email validation and all deletes are intentionally not implemented.
- Single Sends, designs and template versions are created and updated as drafts only: Nexra never sets a Single Send send time, never schedules or sends one, and creates template versions inactive.
- Only the existing single transactional send exists; no new send operations were added.
- New contact and suppression lookups put identifiers and email addresses in POST bodies.
- Segment queries are SGQL written by the user and are sent in the request body; SendGrid validates them asynchronously (queryValidation).
- Email activity requires the paid Email Activity History add-on; without it SendGrid returns HTTP 403.
Developer reference
- Create the Twilio credentials described above with the narrowest permissions your flows need.
- In Nexra, open Connect, then Connections, then New connection, choose SendGrid, enter its settings and credentials, and tick only the write actions you need. Connection guide
- Test the connection, then use its actions as flow sources and destinations. Flow guide
Machine-readable detail: GET /api/public/connect/connectors/sendgrid and the Connections API.