SendGrid

Connect AI agents to SendGrid. Agents send transactional and templated email, upsert and search contacts, manage lists, maintain unsubscribe and bounce suppressions, validate addresses, and read email stats.

18 actions available

A new lead is captured in another system

Agent runs Validate Email on the address before anything is sent

Agent calls Upsert Contacts to add or update the contact on a list

Agent sends the welcome message with Send Templated Email

Agent reads Get Email Stats to confirm the send registered

Marketing channel gets a summary of the day's sends

A send to a large list segment routes for approval before it queues

What This Integration Enables

An agent can send transactional email with plain-text or HTML bodies, or send from a dynamic template with Handlebars substitution values supplied at send time. It upserts contacts into Marketing Campaigns lists, searches them with SendGrid's SGQL query language, retrieves a contact by exact email, and manages lists. Sends are queued asynchronously, so the agent works from the returned job status rather than assuming instant delivery. Around the send, the agent keeps deliverability honest. It validates an address before sending, reads and edits the global unsubscribe and bounce suppression lists, pulls global email statistics for a date range, and checks which sender identities are verified. SendGrid exposes no event triggers in this integration, so flows start from the systems feeding it: a CRM, a form, or a scheduled sweep. The agent is the bridge that turns those signals into deliverable mail and keeps the contact data around it clean.

Without FlowRunner

Bad addresses sent to Emails go out to unverified addresses and drive up the bounce rate

Contacts entered twice The same lead lands on a list again because no lookup runs first

Suppressions ignored Unsubscribed recipients still receive mail because the list is stale

With FlowRunner

Validated before send Validate Email screens the address before the agent queues anything

Upsert keeps contacts single Upsert Contacts matches on email and updates instead of duplicating

Suppression respected The agent maintains global unsubscribes and bounces so opt-outs hold

Use Case Scenarios

Validated Welcome, Deduplicated

A new lead arrives from [HubSpot](/integrations/hubspot). The agent runs Validate Email first, and only for a valid address does it call Upsert Contacts to add the lead to a Marketing Campaigns list, then Send Templated Email to deliver the welcome message. A mistyped address never becomes a hard bounce, and the same lead arriving twice never becomes two contacts.

Clean the Roster Before the Send

The agent reads a mailing roster from [Google Sheets](/integrations/google-sheets) with Get Rows, calls Validate Email on each address, and upserts only the addresses that pass. The list that feeds the next campaign is verified before a single message queues, not cleaned up after the bounces come back.

Campaign Recap to the Team

After a campaign, the agent calls Get Email Stats for the date range, formats the delivered, open, and click figures, and posts the summary to a marketing channel with [Slack](/integrations/slack) Send Message To Channel. The team sees performance without opening the SendGrid dashboard.

Human-in-Loop Highlight

A send to a large list segment is not a step to run unsupervised. Reach is the whole point, and it is also the whole risk: a wrong template or a wrong segment reaches thousands before anyone notices. When the agent is about to send to a segment above the size you set, it treats the send as a [human-in-the-loop](/concepts/human-in-the-loop/) step. It pauses, shows the template name, the target list, and the recipient count, and routes the decision to a marketing owner through Slack or email. The owner approves, and the agent queues the send. The owner holds, and nothing goes out. Routine one-to-one transactional mail flows untouched; the sends that reach a crowd get a human first.

Agent processes routinely

Detects exception requiring judgment

Clear match Continues automatically

Ambiguous Routes to human via Slack

Human decides

Agent resumes with decision

Agent Capabilities

18 actions

Sending

Send Email Sends an email through the SendGrid v3 Mail Send API. Supports multiple To, CC, and BCC recipients, plain-text and HTML bodies, a reply-to address, URL attachments, scheduled sending up to 72 hours ahead, and categories for analytics. At least one of text or HTML content is required. SendGrid queues the message asynchronously, so a successful call confirms the message was queued rather than delivered.
Send Templated Email Sends an email using a SendGrid dynamic transactional template. The template controls the subject and body, and the dynamic template data supplies the Handlebars substitution values. Supports the same recipients, reply-to, attachments, scheduling, and categories as a plain send.

Contacts and Lists

Upsert Contacts Adds new contacts or updates existing ones, matched by email, in SendGrid Marketing Campaigns, optionally adding them to one or more lists. Processing is asynchronous, and the returned job ID tracks the import.
Search Contacts Searches Marketing Campaigns contacts using SendGrid's SGQL query language, for example matching an email pattern or a field value. Returns matching contacts with their full field data and the total match count.
Get Contact By Email Retrieves a single Marketing Campaigns contact by exact email address, including standard fields, list memberships, and custom field values.
Delete Contacts Deletes Marketing Campaigns contacts by a list of contact IDs, or all contacts in the account when delete-all is enabled. Deletion is asynchronous and irreversible.
Create List Creates a new Marketing Campaigns contact list with a name unique within the account. Returns the new list's ID, name, and contact count.
Get Lists Retrieves Marketing Campaigns contact lists with their IDs, names, and contact counts, with cursor pagination.
Delete List Deletes a Marketing Campaigns contact list by ID. By default the contacts are kept and only the list is removed; enabling delete-contacts also deletes every contact on the list.

Templates

List Dynamic Templates Retrieves the dynamic Handlebars transactional templates in your account, including each template's ID, name, and versions with their subjects and active status.

Suppressions

List Global Unsubscribes Retrieves email addresses on the global unsubscribe list, recipients who will not receive any email from your account.
Add Global Unsubscribes Adds one or more email addresses to the global unsubscribe list, preventing them from receiving any email sent through your account.
Delete Global Unsubscribe Removes a single email address from the global unsubscribe list so it can receive email again. Succeeds even if the address was not on the list.
List Bounces Retrieves the bounce suppression list, addresses that hard-bounced and are blocked from further email, each with a bounce reason, SMTP status code, and creation timestamp.
Delete Bounces Removes addresses from the bounce suppression list so SendGrid will attempt delivery again. Provide specific addresses or clear the entire list.

Deliverability and Reporting

Get Email Stats Retrieves global email statistics (requests, delivered, opens, clicks, bounces, spam reports, unsubscribes, and more) for a date range, optionally aggregated by day, week, or month.
Validate Email Validates a single email address in real time. Returns a validity verdict, a score, and detailed checks for domain validity, known bounces, role addresses, and disposable domains. This action requires a SendGrid plan that includes Email Address Validation.
Get Verified Senders Retrieves the verified sender identities in your account, including each sender's from and reply-to addresses, nickname, and verification status. Only verified senders can be used as the from address.

Start building with SendGrid

$100 in credits. No card required. Connect in minutes.

Start Building Free Talk to us