Sendgrid MCP for AI Agents

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Sendgrid MCP or direct API to send emails, manage templates, check delivery status, and analyze engagement—all through natural language.
Trusted by
AWS
Glean
Zoom
Airtable
GET STARTED FOR FREEGET A DEMO

30 min · no commitment · see it on your stack

Sendgrid Logo
Gradient Top
Gradient Middle
Gradient Bottom
divider

Try Sendgrid now

Enter a prompt below to test the integration in our Tool Router playground. You'll be redirected to sign in and try it live.

Supported Tools

Tools
Activate template versionActivates a specific version of a transactional template, making it the default version used when sending emails.
Add a batch of ips to an ip poolAdds a batch of IP addresses to a specified IP Pool in SendGrid.
Add an ip address to a poolAdds a dedicated IP address to an IP pool in your SendGrid account.
Add an ip to an authenticated domainAdd an IP address to an authenticated domain for custom SPF configuration.
Add a twilio sendgrid ip addressProvisions a new Twilio SendGrid IP address to your account.
Add ipsAdd dedicated IP addresses to your SendGrid account.
Add one or more ips to the allow listAdds one or more IPv4 addresses to your SendGrid account's IP access management allow list.
Add or update a contactAdds or updates contacts in SendGrid Marketing Campaigns.
Add suppressions to a suppression group**This endpoint allows you to add email addresses to an unsubscribe group.
Add recipient addresses to the global suppression groupAdds one or more email addresses to the global suppression group.
Approve access request**This endpoint allows you to approve an access attempt.
Assign a batch of subusers to an ipAssigns multiple subusers to a specified IP address in a single operation.
Associate a branded link with a subuserAssociate a branded link with a subuser account for email link tracking.
Associate an authenticated domain with a given userAssociate an authenticated domain with a subuser, allowing the subuser to send emails using the parent account's domain authentication.
Authenticate a domainThe endpoint enables domain authentication for users or subusers, offering two methods—'username' parameter for visibility and modification, or the Association workflow for a fixed, non-editable domain assignment.
Authenticate an account with single sign onGenerates a one-time SSO authentication URL for logging into a customer's Twilio SendGrid account.
Bind authenticated domains to userAssociates an additional authenticated domain with a subuser.
Bulk delete single sendsPermanently deletes multiple Single Sends in a single operation by providing their IDs.
Cancel or pause a scheduled sendCancel or pause a group of scheduled email sends by their batch_id.
Completed stepsRetrieves the verification status of a SendGrid account, checking if Domain Authentication and Single Sender Verification have been completed.
Create a batch idGenerate a new mail batch ID to group multiple email sends together.
Create a branded linkCreate a new branded link by specifying the root domain, which must align with your FROM email, and an optional unique subdomain.
Create a campaignThis endpoint enables campaign creation, requiring a subject, sender ID, content (HTML and text suggested), and a list or segment ID for sending or scheduling, but not for initial creation.
Create a custom fieldCreates a custom field for storing additional contact information in SendGrid.
Create a listCreate a new contact list in SendGrid's Marketing Campaigns.
Create an accountCreates a new customer account under your organization using the Account Provisioning API.
Create a new alertCreate a new SendGrid alert.
Create a new event webhookSet up an Event Webhook by providing a URL, choosing events for POST requests, and receive a unique ID.
Create a new suppression groupCreate a new suppression group (unsubscribe group) to allow recipients to opt out of specific types of emails.
Create a new transactional template version**This endpoint allows you to create a new version of a template.
Create an ip poolCreates a new IP pool in your SendGrid account.
Create an ip pool with a name and ip assignmentsCreates a new IP Pool in your SendGrid account using the IP Address Management API.
Create an sso certificateCreate an SSO certificate for SAML 2.
Create an sso integrationCreate a new Single Sign-On (SSO) integration for your SendGrid account.
Create an sso teammateCreates a Single Sign-On (SSO) Teammate in SendGrid.
Create a parse settingCreates a new Inbound Parse Webhook setting to receive and parse incoming emails.
Create api keysCreates a new SendGrid API key with specified permissions.
Create a segmentCreates a new segment in SendGrid's Contact Database (Legacy Marketing Campaigns).
Create a senderCreates a new Sender identity for use in SendGrid Marketing Campaigns.
Create a sender identity**Create a new sender identity in SendGrid.
Create a transactional templateCreate a new transactional email template in SendGrid.
Create custom field definitionCreate unique case-insensitive custom fields with alphanumeric/underscore names starting with a letter/underscore.
Create designCreates a new email design in the SendGrid Design Library.
Create Marketing IntegrationCreate a SendGrid Marketing Integration for email event forwarding to Segment.
Create listCreate a new contact list in SendGrid Marketing Campaigns.
Create segmentCreates a new contact segment using SendGrid's Marketing Campaigns Segmentation V2 API.
Create single sendThe endpoint lets you create a Single Send draft without needing a template ID; it now uses `email_config`.
Create subuser**This endpoint allows you to create a new subuser.
Create verified sender requestThis endpoint creates a new sender identity via `POST`, sends a verification email to `from_email`, and requires email verification.
Delete a batch of ips from an ip poolRemoves a batch of IP addresses from a specified IP Pool in SendGrid.
Delete a batch of subusers from an ipRemoves multiple subusers from a specified IP address in a single batch operation.
Delete a bounceRemoves an email address from your SendGrid bounce suppression list.
Delete a branded linkPermanently delete a branded link from your SendGrid account.
Delete a campaignPermanently deletes a specific marketing campaign from your SendGrid account.
Delete a contact identifierRemoves a specific identifier (EMAIL, PHONENUMBERID, EXTERNALID, or ANONYMOUSID) from a contact without deleting the entire contact.
Delete a custom fieldPermanently deletes a custom field from your SendGrid contact database.
Delete a global suppressionThis endpoint removes an email from suppressions, allowing future emails to be sent to it.
Delete an accountPermanently deletes a customer account under your organization using the Account Provisioning API.
Delete an alertDelete a SendGrid alert by its ID.
Delete an authenticated domainDelete an authenticated domain (formerly known as domain whitelabel) by its ID.
Delete an IP PoolDelete an IP pool by its name using the legacy IP Pools API.
Delete an SSO CertificateDelete an SSO certificate by its unique identifier.
Delete an SSO IntegrationDelete an SSO (Single Sign-On) integration by ID.
Delete a parse settingDeletes a specific inbound parse webhook setting by hostname.
Delete api keys**This endpoint allows you to revoke an existing API Key using an `api_key_id`** Authentications using a revoked API Key will fail after after some small propogation delay.
Delete a reverse dns recordThis endpoint deletes a reverse DNS record, returning a 204 code on success.
Delete a segmentPermanently deletes a segment from the SendGrid Contact Database (Legacy Marketing Campaigns).
Delete a senderPermanently delete an existing Marketing Campaigns Sender identity from your SendGrid account.
Delete a sender identityPermanently deletes a sender identity from your SendGrid account.
Delete a single event webhook by idDelete a specific Event Webhook by ID with this endpoint.
Delete a specific blockDeletes a specific email address from your SendGrid blocks list.
Delete a specific invalid emailRemoves a specific email address from SendGrid's invalid emails suppression list.
Delete a specific spam reportRemoves a specific spam report from SendGrid's suppression list by email address.
Delete a subuserPermanently delete a subuser from your SendGrid account.
Delete a suppression from a suppression groupRemove an email address from a suppression group (unsubscribe group).
Delete a suppression groupThis API endpoint deletes email suppression groups.
Delete a templatePermanently deletes a transactional template from your SendGrid account.
Delete a transactional template version**Delete a specific version of a transactional template.
Delete blocksDelete blocked email addresses from your SendGrid suppression list.
Delete bouncesDelete bounced email addresses from your SendGrid bounce suppression list.
Bulk Delete IntegrationsBulk delete multiple Integrations by providing their IDs as a query parameter.
Delete a cancellation or pause from a scheduled sendResume a paused or cancelled scheduled send by removing its pause/cancel status.
Delete contactsDeletes contacts from your SendGrid Marketing Campaigns account.
Delete custom field definitionPermanently deletes a custom field definition from SendGrid Marketing Campaigns.
Delete design**This endpoint allows you to delete a single design**.
Delete invalid emailsDelete email addresses from your SendGrid invalid emails suppression list.
Delete ip poolDelete an IP Pool from your SendGrid account using the IP Address Management API.
Delete pending teammateDelete a pending teammate invitation that hasn't yet been accepted.
Delete single send by idPermanently deletes a Single Send by its unique ID.
Delete single send scheduleCancel a scheduled Single Send by deleting its scheduled send time.
Delete spam reportsDelete spam reports from your SendGrid spam report suppression list.
Delete teammatePermanently delete a teammate from your SendGrid account.
Delete verified senderDeletes a Verified Sender Identity from your SendGrid account.
Deny access requestDenies a teammate's pending access request.
Disassociate a branded link from a subuserRemove a branded link association from a subuser account.
Domain warn listRetrieves a list of domains known to implement DMARC (Domain-based Message Authentication, Reporting & Conformance) policies, categorized by failure type.
Get Email Activity CSV Download URLRetrieves a presigned S3 URL to download a CSV file of email activity data (up to 1M events, last 30 days).
Duplicate a transactional templateDuplicate an existing transactional template to create a new template with the same content.
Duplicate designDuplicates an existing email design in the SendGrid Design Library.
Duplicate sendgrid pre built designDuplicates a pre-built SendGrid email design template from the SendGrid Design Library.
Duplicate Single SendDuplicates an existing Single Send by its ID, creating a new draft that can be edited via the Update Single Send endpoint (PATCH).
Edit an SSO TeammateUpdates an existing SSO Teammate's permissions and profile in SendGrid.
Edit a transactional templateUpdates the name of an existing transactional template.
Edit a transactional template versionEdit a transactional template version in SendGrid.
Edit verified senderUpdates an existing verified sender identity in SendGrid.
Email dns records to a co workerEmail DNS records to a co-worker for domain authentication or link branding setup.
Enable disable a subuserEnable or disable a SendGrid subuser account.
Enable disable website access for a subuserEnable or disable website portal access for a SendGrid subuser while preserving their email sending capabilities.
Erase recipients email dataPermanently erases recipients' personal email data from SendGrid for GDPR/privacy compliance.
Export contactsInitiates an asynchronous job to export Marketing Campaigns contacts to CSV or JSON.
Export contacts statusRetrieves the status of a contact export job and provides download URLs when ready.
Export single send statsExports Single Send campaign statistics in CSV format.
Filter all messagesFilter and retrieve email activity from the SendGrid Email Activity Feed API.
Filter messages by message idRetrieve detailed information about a specific email message by its unique message ID.
Get account offeringsRetrieves the offerings (email packages and add-ons) assigned to a specific customer account.
Get a contact by idRetrieves the full details of a single contact by their unique ID from SendGrid Marketing Campaigns.
Get a list of all ip addresses on your accountFetches your account's IP addresses with details such as pool association and warm-up status.
Get a list of all sendersRetrieves a list of all Sender identities associated with your SendGrid account.
Get a list of subusers assigned to an ipRetrieves a list of Subuser IDs assigned to a specific IP address in your SendGrid account.
Get all accountsRetrieves all accounts under the organization.
Get all automation statsRetrieve email statistics for SendGrid Marketing Automations (automated email workflows).
Get all available offeringsRetrieves all available SendGrid offerings for account provisioning.
Get All Single Sends CategoriesRetrieve all categories associated with your Marketing Campaigns Single Sends.
Get all existing exportsRetrieves all existing contact export jobs from SendGrid Marketing Campaigns.
Get all field definitionsRetrieve all field definitions including custom and reserved fields from Marketing Campaigns.
Get all ip pools that have associated ipsThe function lists your IP Pools and samples up to 10 IPs from each.
Get all sender identities**This endpoint allows you to retrieve a list of all sender identities that have been created for your account.
Get all single sendsRetrieve a list of your Single Sends with brief details, including their IDs.
Get all single sends statsRetrieve email statistics for SendGrid Single Sends (one-time marketing email campaigns).
Get All SSO Certificates by IntegrationRetrieves all SSO (Single Sign-On) certificates associated with a specific IdP integration.
Get all sso integrations**This endpoint allows you to retrieve all SSO integrations tied to your Twilio SendGrid account.
Get all verified sendersRetrieve all Sender Identities (verified/unverified) for an account via an endpoint.
Get Account StateRetrieve the current state of a customer account using the Account Provisioning API.
Get an SSO CertificateRetrieve an individual SSO certificate by its ID.
Get an sso integration**This endpoint allows you to retrieve an SSO integration by ID.
Get a specific senderRetrieves the details of a specific Marketing Sender by its unique ID.
Get a User's Account InformationRetrieves the authenticated user's SendGrid account details including account type (e.
Get User ProfileRetrieve the authenticated user's profile details.
Get Automation Click Tracking StatsRetrieve click-tracking statistics for a specific SendGrid Marketing Automation.
Get automation stats by idRetrieve detailed stats for a specific Automation by ID, with optional date and aggregation filters, or use another endpoint to get stats for multiple Automations.
Get batched contacts by idsRetrieves multiple SendGrid Marketing Contacts by their IDs in a single batch request.
Get bounce statistics by classificationRetrieve daily bounce statistics filtered by a specific classification type.
Get Bulk Email Validation Job by IDRetrieves the details of a specific Bulk Email Address Validation Job by its ID.
Get Contacts by EmailsSearch for Marketing Campaigns contacts by their email addresses.
Get contacts by identifiersRetrieves up to 100 Marketing Campaigns contacts by searching for specific identifier values.
Get designRetrieves a specific design's details from your Design Library by its ID.
Get details for an ip addressRetrieves detailed information about a specific IP address on your SendGrid account.
Get details for an ip poolThis operation retrieves details of an IP Pool, such as name, ID, some sample IPs (up to 10), and the total IP count.
Retrieve all suppression groups for an email address**Retrieve all suppression groups for a specific email address.
Get engagement quality scoresRetrieve SendGrid Engagement Quality (SEQ) scores for a specified date range.
Retrieve email statistics by country and state provinceRetrieves email engagement statistics (opens, clicks) segmented by geographic location (country and state/province).
Get information on a single suppression groupRetrieves details for a single suppression group (also known as an unsubscribe group).
Get Marketing IntegrationRetrieve a specific Marketing Integration by its unique ID.
Get ips assigned to an ip poolRetrieves IP addresses assigned to a specific IP Pool.
Retrieve the warmup status for a specific ip addressRetrieve the warmup status for a specific dedicated IP address.
Get list contact countRetrieve the contact count and billable contact count for a specific marketing list.
Get list of segmentsRetrieves a filtered list of contact segments from SendGrid Marketing Campaigns V2.
Get Open Tracking SettingsRetrieves the current open tracking settings for your SendGrid account.
Get Recipient Upload Status (Legacy)Retrieves the upload status for recipients in the Legacy Marketing Campaigns contacts database (contactdb).
Get remaining ips count**This endpoint gets amount of IP Addresses that can still be created during a given period and the price of those IPs.
Get sample contactsRetrieves a sample of up to 50 contacts from your Marketing Contacts database, sorted by email address.
Get SendGrid Pre-built DesignRetrieves details of a specific SendGrid pre-built design template by ID.
Get signed event webhook's public keyRetrieves the public key for a specific Event Webhook by ID.
Get single send by id**This endpoint allows you to retrieve details about one Single Send using a Single Send ID.
Get single send click tracking stats by id**This endpoint lets you retrieve click-tracking stats for one Single Send**.
Get single sends searchSearch for Single Sends (marketing email campaigns) by name, status, and/or categories.
Get single send stats by idRetrieve individual Single Send stats using its ID.
Get subuser monthly statsRetrieves monthly email statistics for a specific subuser.
Get subusers engagement quality scoresRetrieve SendGrid Engagement Quality (SEQ) scores for all subusers on a specific date.
Get suppression groupsThis endpoint provides a list of user-created suppression groups and can return info for multiple groups when their IDs are added to the request with `?
Get teammate subuser accessRetrieve Subusers accessible to a specified Teammate, including their permission levels and scopes.
Get the credits for a subuserRetrieves credit information for a specific Subuser account, including the credit type (unlimited, recurring, or nonrecurring), reset frequency, remaining credits, total allowable credits, and used credits.
Get the default authenticationRetrieves the default domain authentication configuration for your SendGrid account.
Get the settings for a single event webhookRetrieves the configuration and settings for a single Event Webhook by its ID.
Get total contact countRetrieve the total number of contacts stored in your SendGrid Marketing Campaigns account.
Retrieve a list of scopes for which this user has accessRetrieve a list of scopes for which this user has access
Import contactsInitiates a bulk contact import by requesting an upload URL for a CSV file.
Import contacts statusCheck the status of a contact import, update, or delete job in SendGrid Marketing Campaigns.
Invite teammateInvite teammates to your account through email with this endpoint, assigning initial permissions via the `scopes` array.
List all authenticated domainsRetrieve authenticated domain lists in pages using the `limit` parameter for page size and `offset` to start from specific list positions.
List all subusersRetrieve a paginated list of subusers with filtering options.
List api keysRetrieve user's API key names and IDs with this endpoint; keys themself cannot be retrieved for security.
List Bulk Email Validation JobsRetrieves a list of all Bulk Email Address Validation Jobs for the account.
List designsList designs from the Design Library.
ListintegrationThis endpoint returns all the Integrations for the user making this call.
List sendgrid pre built designsThe `designs/pre-builts` endpoint fetches a list of Twilio SendGrid's ready-made designs, not user-specific ones, with 100 results per request by default, adjustable with `page_size`.
List the authenticated domain associated with the given userRetrieves all authenticated domains that have been assigned to a specific subuser.
Manually refresh a segmentManually refresh a Marketing Campaigns V2 segment to update its contact membership.
Request Presigned URL for Bulk Email ValidationRequest a presigned URL and headers to upload a file containing email addresses for bulk validation.
Remove an ip address from a poolRemove an IP address from an IP pool in your SendGrid account.
Remove an ip from an authenticated domainRemove an IP address from an authenticated domain's custom SPF configuration.
Remove a specific ip from the allowed listRemoves a specific IP address from your SendGrid account's allow list.
Remove contacts from a listRemove contacts from a marketing list without deleting them from your account.
Remove list and optional contactsDelete a marketing list from your SendGrid account.
Remove one or more ips from the allow listRemoves one or more IP addresses from your SendGrid IP Access Management allow list.
Remove segment without affecting contactsPermanently deletes a segment from SendGrid's Marketing Campaigns without affecting contacts.
Disassociate an authenticated domain from a given userDisassociate ALL authenticated domains from a subuser.
Rename an ip poolRenames an existing IP pool in your SendGrid account.
Request csvInitiating a backend process creates a CSV file of up to 1 million events from the last 30 days, emailed to the user with a 3-day expiry link.
Resend a sender verificationResends the verification email for a Marketing Campaigns Sender identity.
Resend sender identity verificationResends the verification email to a sender identity's 'from' email address.
Resend teammate inviteResend a pending teammate invitation to refresh its expiration date.
Resend verified sender requestResends the verification email to a Sender Identity's 'from_email' address.
Retrieve a bounceRetrieves details about a specific bounced email address from the SendGrid suppression list.
Retrieve a branded linkRetrieves a specific branded link by its ID.
Retrieve access requestsRetrieve a list of recent access requests using pagination with `limit` for page size and `offset` to control the start position for additional items.
Retrieve a count of recipientsRetrieve the total count of recipients in the Legacy Marketing Campaigns contact database.
Retrieve a custom fieldRetrieves a single custom field definition by its ID from SendGrid Marketing Campaigns.
Retrieve address whitelist mail settingsRetrieves your current address whitelist mail settings from SendGrid.
Retrieve a global suppressionChecks if an email address is in the global suppression list.
Retrieve a list of currently allowed ipsThis endpoint provides a list of authorized IP addresses for your account, each with creation, update dates, and a unique ID for potential removal.
Retrieve all alertsRetrieve all SendGrid alerts configured for your account.
Retrieve all assigned ipsRetrieves all IP addresses that are currently assigned to your account.
Retrieve all blocksRetrieves a paginated list of all blocked email addresses from your SendGrid account.
Retrieve all bouncesThis endpoint retrieves a paginated list of all your bounces, allowing customization of page size with `limit` and starting position with `offset` for multiple requests.
Retrieve all branded links**This endpoint allows you to retrieve all branded links**.
Retrieve all campaignsRetrieve a paginated list of campaigns in reverse creation order with the API endpoint.
Retrieve all categoriesRetrieve all email categories used for tracking and organizing email statistics.
Retrieve all custom fieldsRetrieve all custom field definitions for contacts.
Retrieve all global suppressionsRetrieves a paginated list of all email addresses that are globally suppressed from receiving any emails from your SendGrid account.
Retrieve all invalid emailsRetrieve paginated lists of invalid emails with 'limit' for page size and 'offset' to start from a specific position for lists exceeding the limit.
Retrieve all ip addressesRetrieve a paginated list of assigned/unassigned IPs with warmup status, pools, subusers, and DNS info.
Retrieve all ip pools**This endpoint allows you to get all of your IP pools.
Retrieve all ip pools an ip address belongs toRetrieves details for a specific IP address including all IP pools it belongs to, subusers that can use it, warmup status, and reverse DNS record.
Retrieve All IPs Currently in WarmupRetrieve all IP addresses currently in the warmup process.
Retrieve all listsRetrieve all contact lists from your SendGrid account.
Retrieve all mail settingsRetrieve a paginated list of mail settings with their `enabled` status and descriptions.
Retrieve all of your event webhooksThe endpoint fetches all Event Webhooks as objects in an array, showing each webhook's configuration and ID, used to update, delete, or manage signature verification and OAuth settings.
Retrieve all parse settings**This endpoint allows you to retrieve all of your current inbound parse settings.
Retrieve all pending teammates**This endpoint allows you to retrieve a list of all pending Teammate invitations.
Retrieve all recent access attemptsRetrieves a list of all IP addresses that have recently attempted to access your SendGrid account, either through the User Interface or the API.
Retrieve all recipients on a listRetrieves all recipients (contacts) belonging to a specific list in SendGrid's Legacy Marketing Campaigns.
Retrieve all reverse dns recordsThe endpoint provides a paginated list of Reverse DNS records, with optional IP prefix search and adjustable page size using 'limit' and 'offset' parameters.
Retrieve all scheduled sendsThe endpoint provides details of cancelled or paused scheduled sends but only if they have a `batch_id`.
Retrieve all spam reportsRetrieve spam reports in pages using `limit` for page size and `offset` to continue from a specific list position.
Retrieve all suppressionsRetrieve a list of all suppressions across all suppression groups.
Retrieve all suppressions for a suppression group**This endpoint allows you to retrieve all suppressed email addresses belonging to the given group.
Retrieve all teammatesRetrieve a paginated list of Teammates with the `limit` parameter to set page size and `offset` to specify the starting point for additional items.
Retrieve all the ips in a specified poolRetrieves all IP addresses that are assigned to a specific IP pool.
Retrieve an authenticated domainRetrieves details of a specific authenticated domain by its unique ID.
Retrieve an existing api keyRetrieves the details of an existing SendGrid API key by its unique identifier.
Retrieve a reverse DNS recordRetrieves a specific reverse DNS (formerly IP Whitelabel) record by its ID.
Retrieve a single campaignRetrieves a specific campaign from SendGrid's Legacy Marketing Campaigns by its ID.
Retrieve a single listRetrieve detailed information about a specific marketing list by its unique ID.
Retrieve a single transactional templateRetrieves a single transactional template by its ID, including all associated template versions.
Retrieve a specific alertRetrieve details for a specific SendGrid alert by its ID.
Retrieve a specific allowed ipRetrieves details of a specific IP address from your SendGrid account's IP Access Management allow list using its unique rule ID.
Retrieve a specific blockRetrieves details for a specific email address from your SendGrid blocks list.
Retrieve a specific invalid emailRetrieves details about a specific email address from SendGrid's invalid email suppression list.
Retrieve a specific parse settingRetrieves a specific inbound parse webhook setting by hostname.
Retrieve a specific spam reportRetrieves a specific spam report by email address from SendGrid's suppression list.
Retrieve a specific transactional template versionRetrieves a specific version of a transactional template by its template ID and version ID.
Retrieve a subuser's branded linkRetrieve the branded link associated with a specific subuser.
Retrieve bounce classification totalsThis endpoint will return the total number of bounces by classification in descending order for each day.
Retrieve bounce purge mail settingsRetrieve your current Bounce Purge mail settings.
Retrieve click track settingsRetrieves your current click tracking settings from SendGrid.
Retrieve Current Enforced TLS SettingsRetrieve the current Enforced TLS settings for your SendGrid account.
Retrieve email statistics by browserRetrieve email statistics segmented by browser type (Chrome, Firefox, Safari, etc.
Retrieve email statistics by client typeRetrieve email statistics segmented by client type (Webmail, Desktop, Phone, Tablet, Other).
Retrieve email statistics by device typeRetrieve email statistics segmented by device type (Desktop, Webmail, Phone, Tablet, Other).
Retrieve email statistics by mailbox providerRetrieve email statistics segmented by recipient mailbox provider (e.
Retrieve email statistics for categoriesRetrieve email statistics for specific categories within a date range.
Retrieve email statistics for your subusersRetrieves email statistics for specified subusers over a date range.
Retrieve footer mail settingsRetrieve your current Footer mail settings from SendGrid.
Retrieve forward bounce mail settingsRetrieves the current forward bounce mail settings for your SendGrid account.
Retrieve forward spam mail settingsRetrieves the current forward spam mail settings for your SendGrid account.
Retrieve global email statisticsRetrieve global email statistics for your SendGrid account within a specific date range.
Retrieve Google Analytics SettingsRetrieves the current Google Analytics tracking settings for your SendGrid account.
Retrieve legacy template mail settingsRetrieves your current legacy email template mail settings.
Retrieve monthly stats for all subusersRetrieves monthly email statistics for all subusers.
Retrieve paged transactional templates**This endpoint allows you to retrieve all transactional templates.
Retrieve recipientsRetrieve all marketing campaign recipients via this endpoint.
Retrieve recipients on a segmentRetrieves all recipients (contacts) in a specified segment from SendGrid's Legacy Marketing Campaigns Contact Database.
Retrieve reserved fields**Retrieve all reserved fields from the Legacy Marketing Campaigns Contact Database.
Retrieve scheduled sendRetrieve the cancel/pause status of a scheduled email batch by its batch_id.
Retrieves inbound parse webhook statisticsRetrieve statistics for emails processed by SendGrid's Inbound Parse Webhook.
Retrieve single segment endpointRetrieves detailed information about a specific Marketing Campaigns segment by its unique ID.
Retrieve specific teammateRetrieves details of a specific SendGrid teammate by username.
Retrieve stats by a specific client typeRetrieve email statistics for a specific client type (phone, tablet, webmail, or desktop).
Retrieve subscription tracking settingsRetrieves the current subscription tracking settings for your SendGrid account.
Retrieve subuser reputationsRetrieves sender reputation scores (0-100) for subusers.
Retrieve sums of email stats for each categoryRetrieve aggregated email statistics sums for each category over a date range.
Retrieve the count of billable recipients (Legacy)Retrieves the count of billable recipients for SendGrid Legacy Marketing Campaigns.
Retrieve the default branded linkRetrieves the default branded link for message sending.
Retrieve the lists that a recipient is onRetrieves all marketing campaign lists that a specific recipient belongs to.
Retrieve tracking settings**This endpoint allows you to retrieve a list of all tracking settings on your account.
Retrieve User's Authenticated DomainsRetrieve authenticated domains (up to five) assigned to a specific subuser.
Retrieve your account email addressRetrieves the email address currently on file for your SendGrid account.
Retrieve your credit balanceRetrieves the current email credit balance for your SendGrid account.
Retrieve your usernameRetrieve your current SendGrid account username and user ID.
Returns a list of all partner settingsRetrieve a paginated list of all partner settings that can be enabled for your SendGrid account.
Schedule a campaignSchedules a Legacy Marketing Campaigns email for delivery at a specific time.
Schedule single sendSchedule a Single Send for immediate or future delivery.
Search contactsFind contacts using this endpoint with a body containing a `query` in SGQL.
Search for suppressions within a group**This endpoint allows you to search a suppression group for multiple suppressions.
Search recipientsSearch for recipients in the Legacy Marketing Campaigns contact database by field value.
Send a campaignImmediately sends an existing marketing campaign to its configured recipients.
Send a test marketing emailSend a test marketing email before launching a campaign.
Send email with twilio sendgridThe Mail Send operation uses SendGrid's v3 API to send emails.
Set up reverse dnsSet up reverse DNS (rDNS) for a dedicated IP address.
Start warming up an ip addressPut a dedicated IP address into warmup mode.
Stop warming up an ip addressStop warming up a dedicated IP address and remove automatic sending limits.
Sum email stats for subusersRetrieves summed email statistics for all subusers over a date range.
Test an Event Webhook's SettingsSends a test event notification to a specified URL to verify your webhook endpoint is properly configured to receive SendGrid events.
Toggle signature verification for a single event webhook by idEnable or disable signature verification for a single Event Webhook by its ID.
Unlink subuser domainDisassociate an authenticated domain from a subuser.
Unschedule a scheduled campaignUnschedule a campaign that has already been scheduled to be sent.
Update a branded linkUpdate a specific branded link's default status.
Update a campaignUpdates an existing marketing campaign.
Update account offeringsUpdates the offerings (email packages and add-ons) assigned to a customer account.
Update address whitelist mail settingsUpdates the address whitelist mail settings for your SendGrid account.
Update a listUpdates the name of an existing recipient list in the Marketing Campaigns.
Update Account StateUpdate the state of a customer account using the Account Provisioning API.
Update an alertUpdate an existing SendGrid alert's settings.
Update an authenticated domainUpdates the settings for an authenticated domain in SendGrid.
Update an IP Pool NameUpdates the name of an existing IP Pool in your SendGrid account.
Update an SSO IntegrationUpdate an existing Single Sign-On (SSO) integration for your SendGrid account.
Update a parse settingUpdates an existing Inbound Parse Webhook setting by hostname.
Update API Key NameUpdates the name of an existing SendGrid API key.
Update api key name and scopesUpdates both the name and permission scopes of an existing SendGrid API key.
Update a scheduled campaignUpdates the scheduled send time for a Legacy Marketing Campaigns email.
Update a scheduled sendUpdate the status of a scheduled send batch that already has a pause or cancel status.
Update a segmentUpdates an existing segment in SendGrid's Marketing Campaigns using the Segmentation V2 API.
Update a senderUpdates an existing Sender identity for use in SendGrid Marketing Campaigns.
Update a sender identityUpdates an existing sender identity in SendGrid.
Update a single event webhook by idUpdates the configuration of a specific Event Webhook by its ID.
Update a suppression groupUpdates an existing suppression group (also known as an unsubscribe group).
Update a User's ProfileUpdates the authenticated user's profile information in SendGrid.
Update bounce purge mail settingsUpdate your Bounce Purge mail settings in SendGrid.
Update click tracking settingsUpdates click tracking settings for your SendGrid account.
Update custom field definitionUpdates the name of an existing custom field in SendGrid Marketing Contacts.
Update designUpdates an existing email design in the SendGrid Design Library using PATCH.
Update details for an ip addressUpdates settings for a dedicated IP address in your SendGrid account.
Update enforced tls settingsUpdate the Enforced TLS settings for your SendGrid account.
Update footer mail settingsUpdate your Footer mail settings in SendGrid.
Update forward bounce mail settingsUpdates the forward bounce mail settings for your SendGrid account.
Update forward spam mail settingsUpdates the Forward Spam mail settings for your SendGrid account.
Update Google Analytics SettingsUpdates Google Analytics tracking settings for your SendGrid account.
Update Marketing IntegrationUpdate an existing Marketing Integration by its unique ID.
Update listUpdate the name of an existing contact list in SendGrid Marketing Campaigns.
Update open tracking settingsUpdates open tracking settings for your SendGrid account.
Update single sendUpdate a Single Send draft by its ID.
Update SSO CertificateUpdate an existing SSO (Single Sign-On) certificate by its ID.
Update subscription tracking settingsUpdates subscription tracking settings for your SendGrid account.
Update Teammate's PermissionsUpdates a teammate's permissions in your SendGrid account.
Update template mail settingsUpdates the legacy email template mail settings for your SendGrid account.
Update the credits for a subuserUpdate the credit allocation settings for a SendGrid Subuser.
Update the remaining credits for a subuserUpdates the remaining credits for a specific Subuser account by adding or subtracting from the current credit balance.
Update your account email addressUpdates the email address currently on file for your SendGrid account.
Update your passwordUpdate the password for your SendGrid account.
Update your usernameUpdate the username for your SendGrid account.
Validate a batch IDValidate whether a mail batch ID exists in SendGrid's system.
Validate a branded link**This endpoint allows you to validate a branded link.
Validate a domain authentication**This endpoint allows you to validate an authenticated domain.
Validate an emailValidates an email address and returns a verdict on its validity.
Validate a reverse dns recordValidate a reverse DNS (rDNS) record to check if DNS is properly configured.
Verify sender requestVerifies a sender identity using a token from the verification email.
View a sender identityRetrieves the details of a specific Legacy Sender Identity by its unique ID.
View scheduled time of a campaignRetrieves the scheduled send date and time for a Legacy Marketing Campaign.
Python
TypeScript

Install Composio

python
pip install composio claude-agent-sdk
Install the Composio SDK and Claude Agent SDK

Create Tool Router Session

python
from composio import Composio
from claude_agent_sdk import ClaudeSDKClient, ClaudeAgentOptions

composio = Composio(api_key='your-composio-api-key')
session = composio.create(user_id='your-user-id')
url = session.mcp.url
Initialize the Composio client and create a Tool Router session

Connect to AI Agent

python
import asyncio

options = ClaudeAgentOptions(
    permission_mode='bypassPermissions',
    mcp_servers={
        'tool_router': {
            'type': 'http',
            'url': url,
            'headers': {
                'x-api-key': 'your-composio-api-key'
            }
        }
    },
    system_prompt='You are a helpful assistant with access to Sendgrid tools.',
    max_turns=10
)

async def main():
    async with ClaudeSDKClient(options=options) as client:
        await client.query('Add a single recipient to a Sendgrid list')
        async for message in client.receive_response():
            if hasattr(message, 'content'):
                for block in message.content:
                    if hasattr(block, 'text'):
                        print(block.text)

asyncio.run(main())
Use the MCP server with your AI agent

Why Use Composio?

AI Native Sendgrid Integration

  • Supports both Sendgrid MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for sending emails, managing templates, and fetching stats

Managed Auth

  • Built-in API key management with secure storage
  • Central place to manage, scope, and revoke Sendgrid access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Sendgrid
  • Scoped, least privilege access to Sendgrid resources
  • Full audit trail of agent actions to support review and compliance

Use Sendgrid with any AI Agent Framework

Choose a Framework you want to connect Sendgrid with

Frequently Asked Questions

Do I need my own developer credentials to use Sendgrid with Composio?

Yes, Sendgrid requires you to configure your own API key credentials. Once set up, Composio handles secure credential storage and API request handling for you.

Can I use multiple toolkits together?

Yes! Composio's Tool Router enables agents to use multiple toolkits. Learn more.

Is Composio secure?

Composio is SOC 2 and ISO 27001 compliant with all data encrypted in transit and at rest. Learn more.

What if the API changes?

Composio maintains and updates all toolkit integrations automatically, so your agents always work with the latest API versions.

Used by agents from

Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai
Context
Letta
glean
HubSpot
Agent.ai
Altera
DataStax
Entelligence
Rolai

Never worry about agent reliability

We handle tool reliability, observability, and security so you never have to second-guess an agent action.

Get started for freeGet a demo↗