How to connect Sendgrid to Claude Cowork

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks. This guide walks you through the easiest and most secure way to connect your Sendgrid account to Cowork via Composio Connect, enabling it to add a new contact to newsletter list, activate latest version of promo template, add recipient emails to global suppression group, and more such actions on your behalf without compromising your account security.

Sendgrid logoSendgrid
Api Key

SendGrid is a cloud-based platform for scalable, reliable email delivery. It makes sending transactional and marketing emails effortless and provides deep analytics for every campaign.

359 Tools

Introduction

Cowork is Anthropic's AI agent for knowledge work. Think of it as Claude Code for everything else. It works autonomously with your computer, local files, and applications to accomplish complex tasks.

This guide walks you through the easiest and most secure way to connect your Sendgrid account to Cowork via Composio Connect, enabling it to add a new contact to newsletter list, activate latest version of promo template, add recipient emails to global suppression group, and more such actions on your behalf without compromising your account security.

Also integrate Sendgrid with

Connecting Sendgrid to Claude Cowork

1. Open Customize

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

2. Add the Composio MCP server

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

3. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Cowork

4. Connect your Sendgrid account

Back in Cowork, ask the agent to connect to Sendgrid or give it any Sendgrid-related task.

For example, ask Cowork to:

  • "Add a new contact to newsletter list"
  • "Activate latest version of promo template"
  • "Add recipient emails to global suppression group"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Cowork, and your Sendgrid account is ready to use.

What is Claude Cowork?

Claude Cowork is Anthropic's agent for general knowledge work. It can use your computer, files, and connected applications to complete longer-running tasks across your work tools.

With Composio Connect, Cowork can securely access apps like Sendgrid through MCP without you sharing account credentials directly with the agent.

What is the Sendgrid MCP server, and what's possible with it?

The Sendgrid MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Sendgrid account. It provides structured and secure access to your email delivery platform, so your agent can perform actions like managing contacts, sending transactional emails, organizing IP pools, and handling suppression lists on your behalf.

  • Automated contact and recipient management: Allow your agent to add or update contacts, assign recipients to specific lists, and manage your marketing audiences efficiently.
  • Email template and version control: Enable the agent to activate specific template versions, ensuring your email campaigns always use the latest approved content.
  • IP pool and address management: Let your agent add IP addresses to pools, authenticated domains, or allow lists, helping you scale and secure your email delivery infrastructure.
  • Suppression and compliance automation: Direct the agent to add email addresses to global suppression groups, keeping your mailing lists compliant and minimizing bounces or spam issues.
  • Bulk operations for marketing efficiency: Use the agent to perform batch actions like appending multiple IPs to pools or adding large groups of contacts, streamlining high-volume marketing workflows.
TOOLS

Supported Tools

Every Sendgrid action and event your agent gets out of the box.

Activate template version

Activates a specific version of a transactional template, making it the default version used when sending emails.

Add a batch of ips to an ip pool

Adds a batch of IP addresses to a specified IP Pool in SendGrid.

Add an ip address to a pool

Adds a dedicated IP address to an IP pool in your SendGrid account.

Add an ip to an authenticated domain

Add an IP address to an authenticated domain for custom SPF configuration.

Add a twilio sendgrid ip address

Provisions a new Twilio SendGrid IP address to your account.

Add ips

Add dedicated IP addresses to your SendGrid account.

Add one or more ips to the allow list

Adds one or more IPv4 addresses to your SendGrid account's IP access management allow list.

Add or update a contact

Adds 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 group

Adds 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 ip

Assigns multiple subusers to a specified IP address in a single operation.

Associate a branded link with a subuser

Associate a branded link with a subuser account for email link tracking.

Associate an authenticated domain with a given user

Associate an authenticated domain with a subuser, allowing the subuser to send emails using the parent account's domain authentication.

Authenticate a domain

The 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 on

Generates a one-time SSO authentication URL for logging into a customer's Twilio SendGrid account.

Bind authenticated domains to user

Associates an additional authenticated domain with a subuser.

Bulk delete single sends

Permanently deletes multiple Single Sends in a single operation by providing their IDs.

Cancel or pause a scheduled send

Cancel or pause a group of scheduled email sends by their batch_id.

Completed steps

Retrieves the verification status of a SendGrid account, checking if Domain Authentication and Single Sender Verification have been completed.

Create a batch id

Generate a new mail batch ID to group multiple email sends together.

Create a branded link

Create a new branded link by specifying the root domain, which must align with your FROM email, and an optional unique subdomain.

Create a campaign

This 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 field

Creates a custom field for storing additional contact information in SendGrid.

Create a list

Create a new contact list in SendGrid's Marketing Campaigns.

Create an account

Creates a new customer account under your organization using the Account Provisioning API.

Create a new alert

Create a new SendGrid alert.

Create a new event webhook

Set up an Event Webhook by providing a URL, choosing events for POST requests, and receive a unique ID.

Create a new suppression group

Create 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 pool

Creates a new IP pool in your SendGrid account.

Create an ip pool with a name and ip assignments

Creates a new IP Pool in your SendGrid account using the IP Address Management API.

Create an sso certificate

Create an SSO certificate for SAML 2.

Create an sso integration

Create a new Single Sign-On (SSO) integration for your SendGrid account.

Create an sso teammate

Creates a Single Sign-On (SSO) Teammate in SendGrid.

Create a parse setting

Creates a new Inbound Parse Webhook setting to receive and parse incoming emails.

Create api keys

Creates a new SendGrid API key with specified permissions.

Create a segment

Creates a new segment in SendGrid's Contact Database (Legacy Marketing Campaigns).

Create a sender

Creates a new Sender identity for use in SendGrid Marketing Campaigns.

Create a sender identity

**Create a new sender identity in SendGrid.

Create a transactional template

Create a new transactional email template in SendGrid.

Create custom field definition

Create unique case-insensitive custom fields with alphanumeric/underscore names starting with a letter/underscore.

Create design

Creates a new email design in the SendGrid Design Library.

Create Marketing Integration

Create a SendGrid Marketing Integration for email event forwarding to Segment.

Create list

Create a new contact list in SendGrid Marketing Campaigns.

Create segment

Creates a new contact segment using SendGrid's Marketing Campaigns Segmentation V2 API.

Create single send

The 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 request

This 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 pool

Removes a batch of IP addresses from a specified IP Pool in SendGrid.

Delete a batch of subusers from an ip

Removes multiple subusers from a specified IP address in a single batch operation.

Delete a bounce

Removes an email address from your SendGrid bounce suppression list.

Delete a branded link

Permanently delete a branded link from your SendGrid account.

Delete a campaign

Permanently deletes a specific marketing campaign from your SendGrid account.

Delete a contact identifier

Removes a specific identifier (EMAIL, PHONENUMBERID, EXTERNALID, or ANONYMOUSID) from a contact without deleting the entire contact.

Delete a custom field

Permanently deletes a custom field from your SendGrid contact database.

Delete a global suppression

This endpoint removes an email from suppressions, allowing future emails to be sent to it.

Delete an account

Permanently deletes a customer account under your organization using the Account Provisioning API.

Delete an alert

Delete a SendGrid alert by its ID.

Delete an authenticated domain

Delete an authenticated domain (formerly known as domain whitelabel) by its ID.

Delete an IP Pool

Delete an IP pool by its name using the legacy IP Pools API.

Delete an SSO Certificate

Delete an SSO certificate by its unique identifier.

Delete an SSO Integration

Delete an SSO (Single Sign-On) integration by ID.

Delete a parse setting

Deletes 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 record

This endpoint deletes a reverse DNS record, returning a 204 code on success.

Delete a segment

Permanently deletes a segment from the SendGrid Contact Database (Legacy Marketing Campaigns).

Delete a sender

Permanently delete an existing Marketing Campaigns Sender identity from your SendGrid account.

Delete a sender identity

Permanently deletes a sender identity from your SendGrid account.

Delete a single event webhook by id

Delete a specific Event Webhook by ID with this endpoint.

Delete a specific block

Deletes a specific email address from your SendGrid blocks list.

Delete a specific invalid email

Removes a specific email address from SendGrid's invalid emails suppression list.

Delete a specific spam report

Removes a specific spam report from SendGrid's suppression list by email address.

Delete a subuser

Permanently delete a subuser from your SendGrid account.

Delete a suppression from a suppression group

Remove an email address from a suppression group (unsubscribe group).

Delete a suppression group

This API endpoint deletes email suppression groups.

Delete a template

Permanently deletes a transactional template from your SendGrid account.

Delete a transactional template version

**Delete a specific version of a transactional template.

Delete blocks

Delete blocked email addresses from your SendGrid suppression list.

Delete bounces

Delete bounced email addresses from your SendGrid bounce suppression list.

Bulk Delete Integrations

Bulk delete multiple Integrations by providing their IDs as a query parameter.

Delete a cancellation or pause from a scheduled send

Resume a paused or cancelled scheduled send by removing its pause/cancel status.

Delete contacts

Deletes contacts from your SendGrid Marketing Campaigns account.

Delete custom field definition

Permanently deletes a custom field definition from SendGrid Marketing Campaigns.

Delete design

**This endpoint allows you to delete a single design**.

Delete invalid emails

Delete email addresses from your SendGrid invalid emails suppression list.

Delete ip pool

Delete an IP Pool from your SendGrid account using the IP Address Management API.

Delete pending teammate

Delete a pending teammate invitation that hasn't yet been accepted.

Delete single send by id

Permanently deletes a Single Send by its unique ID.

Delete single send schedule

Cancel a scheduled Single Send by deleting its scheduled send time.

Delete spam reports

Delete spam reports from your SendGrid spam report suppression list.

Delete teammate

Permanently delete a teammate from your SendGrid account.

Delete verified sender

Deletes a Verified Sender Identity from your SendGrid account.

Deny access request

Denies a teammate's pending access request.

Disassociate a branded link from a subuser

Remove a branded link association from a subuser account.

Domain warn list

Retrieves a list of domains known to implement DMARC (Domain-based Message Authentication, Reporting & Conformance) policies, categorized by failure type.

Get Email Activity CSV Download URL

Retrieves a presigned S3 URL to download a CSV file of email activity data (up to 1M events, last 30 days).

Duplicate a transactional template

Duplicate an existing transactional template to create a new template with the same content.

Duplicate design

Duplicates an existing email design in the SendGrid Design Library.

Duplicate sendgrid pre built design

Duplicates a pre-built SendGrid email design template from the SendGrid Design Library.

Duplicate Single Send

Duplicates 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 Teammate

Updates an existing SSO Teammate's permissions and profile in SendGrid.

Edit a transactional template

Updates the name of an existing transactional template.

Edit a transactional template version

Edit a transactional template version in SendGrid.

Edit verified sender

Updates an existing verified sender identity in SendGrid.

Email dns records to a co worker

Email DNS records to a co-worker for domain authentication or link branding setup.

Enable disable a subuser

Enable or disable a SendGrid subuser account.

Enable disable website access for a subuser

Enable or disable website portal access for a SendGrid subuser while preserving their email sending capabilities.

Erase recipients email data

Permanently erases recipients' personal email data from SendGrid for GDPR/privacy compliance.

Export contacts

Initiates an asynchronous job to export Marketing Campaigns contacts to CSV or JSON.

Export contacts status

Retrieves the status of a contact export job and provides download URLs when ready.

Export single send stats

Exports Single Send campaign statistics in CSV format.

Filter all messages

Filter and retrieve email activity from the SendGrid Email Activity Feed API.

Filter messages by message id

Retrieve detailed information about a specific email message by its unique message ID.

Get account offerings

Retrieves the offerings (email packages and add-ons) assigned to a specific customer account.

Get a contact by id

Retrieves the full details of a single contact by their unique ID from SendGrid Marketing Campaigns.

Get a list of all ip addresses on your account

Fetches your account's IP addresses with details such as pool association and warm-up status.

Get a list of all senders

Retrieves a list of all Sender identities associated with your SendGrid account.

Get a list of subusers assigned to an ip

Retrieves a list of Subuser IDs assigned to a specific IP address in your SendGrid account.

Get all accounts

Retrieves all accounts under the organization.

Get all automation stats

Retrieve email statistics for SendGrid Marketing Automations (automated email workflows).

Get all available offerings

Retrieves all available SendGrid offerings for account provisioning.

Get All Single Sends Categories

Retrieve all categories associated with your Marketing Campaigns Single Sends.

Get all existing exports

Retrieves all existing contact export jobs from SendGrid Marketing Campaigns.

Get all field definitions

Retrieve all field definitions including custom and reserved fields from Marketing Campaigns.

Get all ip pools that have associated ips

The 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 sends

Retrieve a list of your Single Sends with brief details, including their IDs.

Get all single sends stats

Retrieve email statistics for SendGrid Single Sends (one-time marketing email campaigns).

Get All SSO Certificates by Integration

Retrieves 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 senders

Retrieve all Sender Identities (verified/unverified) for an account via an endpoint.

Get Account State

Retrieve the current state of a customer account using the Account Provisioning API.

Get an SSO Certificate

Retrieve 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 sender

Retrieves the details of a specific Marketing Sender by its unique ID.

Get a User's Account Information

Retrieves the authenticated user's SendGrid account details including account type (e.

Get User Profile

Retrieve the authenticated user's profile details.

Get Automation Click Tracking Stats

Retrieve click-tracking statistics for a specific SendGrid Marketing Automation.

Get automation stats by id

Retrieve 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 ids

Retrieves multiple SendGrid Marketing Contacts by their IDs in a single batch request.

Get bounce statistics by classification

Retrieve daily bounce statistics filtered by a specific classification type.

Get Bulk Email Validation Job by ID

Retrieves the details of a specific Bulk Email Address Validation Job by its ID.

Get Contacts by Emails

Search for Marketing Campaigns contacts by their email addresses.

Get contacts by identifiers

Retrieves up to 100 Marketing Campaigns contacts by searching for specific identifier values.

Get design

Retrieves a specific design's details from your Design Library by its ID.

Get details for an ip address

Retrieves detailed information about a specific IP address on your SendGrid account.

Get details for an ip pool

This 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 scores

Retrieve SendGrid Engagement Quality (SEQ) scores for a specified date range.

Retrieve email statistics by country and state province

Retrieves email engagement statistics (opens, clicks) segmented by geographic location (country and state/province).

Get information on a single suppression group

Retrieves details for a single suppression group (also known as an unsubscribe group).

Get Marketing Integration

Retrieve a specific Marketing Integration by its unique ID.

Get ips assigned to an ip pool

Retrieves IP addresses assigned to a specific IP Pool.

Retrieve the warmup status for a specific ip address

Retrieve the warmup status for a specific dedicated IP address.

Get list contact count

Retrieve the contact count and billable contact count for a specific marketing list.

Get list of segments

Retrieves a filtered list of contact segments from SendGrid Marketing Campaigns V2.

Get Open Tracking Settings

Retrieves 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 contacts

Retrieves a sample of up to 50 contacts from your Marketing Contacts database, sorted by email address.

Get SendGrid Pre-built Design

Retrieves details of a specific SendGrid pre-built design template by ID.

Get signed event webhook's public key

Retrieves 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 search

Search for Single Sends (marketing email campaigns) by name, status, and/or categories.

Get single send stats by id

Retrieve individual Single Send stats using its ID.

Get subuser monthly stats

Retrieves monthly email statistics for a specific subuser.

Get subusers engagement quality scores

Retrieve SendGrid Engagement Quality (SEQ) scores for all subusers on a specific date.

Get suppression groups

This 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 access

Retrieve Subusers accessible to a specified Teammate, including their permission levels and scopes.

Get the credits for a subuser

Retrieves 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 authentication

Retrieves the default domain authentication configuration for your SendGrid account.

Get the settings for a single event webhook

Retrieves the configuration and settings for a single Event Webhook by its ID.

Get total contact count

Retrieve the total number of contacts stored in your SendGrid Marketing Campaigns account.

Retrieve a list of scopes for which this user has access

Retrieve a list of scopes for which this user has access

Import contacts

Initiates a bulk contact import by requesting an upload URL for a CSV file.

Import contacts status

Check the status of a contact import, update, or delete job in SendGrid Marketing Campaigns.

Invite teammate

Invite teammates to your account through email with this endpoint, assigning initial permissions via the `scopes` array.

List all authenticated domains

Retrieve authenticated domain lists in pages using the `limit` parameter for page size and `offset` to start from specific list positions.

List all subusers

Retrieve a paginated list of subusers with filtering options.

List api keys

Retrieve user's API key names and IDs with this endpoint; keys themself cannot be retrieved for security.

List Bulk Email Validation Jobs

Retrieves a list of all Bulk Email Address Validation Jobs for the account.

List designs

List designs from the Design Library.

Listintegration

This endpoint returns all the Integrations for the user making this call.

List sendgrid pre built designs

The `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 user

Retrieves all authenticated domains that have been assigned to a specific subuser.

Manually refresh a segment

Manually refresh a Marketing Campaigns V2 segment to update its contact membership.

Request Presigned URL for Bulk Email Validation

Request a presigned URL and headers to upload a file containing email addresses for bulk validation.

Remove an ip address from a pool

Remove an IP address from an IP pool in your SendGrid account.

Remove an ip from an authenticated domain

Remove an IP address from an authenticated domain's custom SPF configuration.

Remove a specific ip from the allowed list

Removes a specific IP address from your SendGrid account's allow list.

Remove contacts from a list

Remove contacts from a marketing list without deleting them from your account.

Remove list and optional contacts

Delete a marketing list from your SendGrid account.

Remove one or more ips from the allow list

Removes one or more IP addresses from your SendGrid IP Access Management allow list.

Remove segment without affecting contacts

Permanently deletes a segment from SendGrid's Marketing Campaigns without affecting contacts.

Disassociate an authenticated domain from a given user

Disassociate ALL authenticated domains from a subuser.

Rename an ip pool

Renames an existing IP pool in your SendGrid account.

Request csv

Initiating 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 verification

Resends the verification email for a Marketing Campaigns Sender identity.

Resend sender identity verification

Resends the verification email to a sender identity's 'from' email address.

Resend teammate invite

Resend a pending teammate invitation to refresh its expiration date.

Resend verified sender request

Resends the verification email to a Sender Identity's 'from_email' address.

Retrieve a bounce

Retrieves details about a specific bounced email address from the SendGrid suppression list.

Retrieve a branded link

Retrieves a specific branded link by its ID.

Retrieve access requests

Retrieve 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 recipients

Retrieve the total count of recipients in the Legacy Marketing Campaigns contact database.

Retrieve a custom field

Retrieves a single custom field definition by its ID from SendGrid Marketing Campaigns.

Retrieve address whitelist mail settings

Retrieves your current address whitelist mail settings from SendGrid.

Retrieve a global suppression

Checks if an email address is in the global suppression list.

Retrieve a list of currently allowed ips

This 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 alerts

Retrieve all SendGrid alerts configured for your account.

Retrieve all assigned ips

Retrieves all IP addresses that are currently assigned to your account.

Retrieve all blocks

Retrieves a paginated list of all blocked email addresses from your SendGrid account.

Retrieve all bounces

This 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 campaigns

Retrieve a paginated list of campaigns in reverse creation order with the API endpoint.

Retrieve all categories

Retrieve all email categories used for tracking and organizing email statistics.

Retrieve all custom fields

Retrieve all custom field definitions for contacts.

Retrieve all global suppressions

Retrieves a paginated list of all email addresses that are globally suppressed from receiving any emails from your SendGrid account.

Retrieve all invalid emails

Retrieve 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 addresses

Retrieve 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 to

Retrieves 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 Warmup

Retrieve all IP addresses currently in the warmup process.

Retrieve all lists

Retrieve all contact lists from your SendGrid account.

Retrieve all mail settings

Retrieve a paginated list of mail settings with their `enabled` status and descriptions.

Retrieve all of your event webhooks

The 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 attempts

Retrieves 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 list

Retrieves all recipients (contacts) belonging to a specific list in SendGrid's Legacy Marketing Campaigns.

Retrieve all reverse dns records

The 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 sends

The endpoint provides details of cancelled or paused scheduled sends but only if they have a `batch_id`.

Retrieve all spam reports

Retrieve spam reports in pages using `limit` for page size and `offset` to continue from a specific list position.

Retrieve all suppressions

Retrieve 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 teammates

Retrieve 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 pool

Retrieves all IP addresses that are assigned to a specific IP pool.

Retrieve an authenticated domain

Retrieves details of a specific authenticated domain by its unique ID.

Retrieve an existing api key

Retrieves the details of an existing SendGrid API key by its unique identifier.

Retrieve a reverse DNS record

Retrieves a specific reverse DNS (formerly IP Whitelabel) record by its ID.

Retrieve a single campaign

Retrieves a specific campaign from SendGrid's Legacy Marketing Campaigns by its ID.

Retrieve a single list

Retrieve detailed information about a specific marketing list by its unique ID.

Retrieve a single transactional template

Retrieves a single transactional template by its ID, including all associated template versions.

Retrieve a specific alert

Retrieve details for a specific SendGrid alert by its ID.

Retrieve a specific allowed ip

Retrieves details of a specific IP address from your SendGrid account's IP Access Management allow list using its unique rule ID.

Retrieve a specific block

Retrieves details for a specific email address from your SendGrid blocks list.

Retrieve a specific invalid email

Retrieves details about a specific email address from SendGrid's invalid email suppression list.

Retrieve a specific parse setting

Retrieves a specific inbound parse webhook setting by hostname.

Retrieve a specific spam report

Retrieves a specific spam report by email address from SendGrid's suppression list.

Retrieve a specific transactional template version

Retrieves a specific version of a transactional template by its template ID and version ID.

Retrieve a subuser's branded link

Retrieve the branded link associated with a specific subuser.

Retrieve bounce classification totals

This endpoint will return the total number of bounces by classification in descending order for each day.

Retrieve bounce purge mail settings

Retrieve your current Bounce Purge mail settings.

Retrieve click track settings

Retrieves your current click tracking settings from SendGrid.

Retrieve Current Enforced TLS Settings

Retrieve the current Enforced TLS settings for your SendGrid account.

Retrieve email statistics by browser

Retrieve email statistics segmented by browser type (Chrome, Firefox, Safari, etc.

Retrieve email statistics by client type

Retrieve email statistics segmented by client type (Webmail, Desktop, Phone, Tablet, Other).

Retrieve email statistics by device type

Retrieve email statistics segmented by device type (Desktop, Webmail, Phone, Tablet, Other).

Retrieve email statistics by mailbox provider

Retrieve email statistics segmented by recipient mailbox provider (e.

Retrieve email statistics for categories

Retrieve email statistics for specific categories within a date range.

Retrieve email statistics for your subusers

Retrieves email statistics for specified subusers over a date range.

Retrieve footer mail settings

Retrieve your current Footer mail settings from SendGrid.

Retrieve forward bounce mail settings

Retrieves the current forward bounce mail settings for your SendGrid account.

Retrieve forward spam mail settings

Retrieves the current forward spam mail settings for your SendGrid account.

Retrieve global email statistics

Retrieve global email statistics for your SendGrid account within a specific date range.

Retrieve Google Analytics Settings

Retrieves the current Google Analytics tracking settings for your SendGrid account.

Retrieve legacy template mail settings

Retrieves your current legacy email template mail settings.

Retrieve monthly stats for all subusers

Retrieves monthly email statistics for all subusers.

Retrieve paged transactional templates

**This endpoint allows you to retrieve all transactional templates.

Retrieve recipients

Retrieve all marketing campaign recipients via this endpoint.

Retrieve recipients on a segment

Retrieves 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 send

Retrieve the cancel/pause status of a scheduled email batch by its batch_id.

Retrieves inbound parse webhook statistics

Retrieve statistics for emails processed by SendGrid's Inbound Parse Webhook.

Retrieve single segment endpoint

Retrieves detailed information about a specific Marketing Campaigns segment by its unique ID.

Retrieve specific teammate

Retrieves details of a specific SendGrid teammate by username.

Retrieve stats by a specific client type

Retrieve email statistics for a specific client type (phone, tablet, webmail, or desktop).

Retrieve subscription tracking settings

Retrieves the current subscription tracking settings for your SendGrid account.

Retrieve subuser reputations

Retrieves sender reputation scores (0-100) for subusers.

Retrieve sums of email stats for each category

Retrieve 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 link

Retrieves the default branded link for message sending.

Retrieve the lists that a recipient is on

Retrieves 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 Domains

Retrieve authenticated domains (up to five) assigned to a specific subuser.

Retrieve your account email address

Retrieves the email address currently on file for your SendGrid account.

Retrieve your credit balance

Retrieves the current email credit balance for your SendGrid account.

Retrieve your username

Retrieve your current SendGrid account username and user ID.

Returns a list of all partner settings

Retrieve a paginated list of all partner settings that can be enabled for your SendGrid account.

Schedule a campaign

Schedules a Legacy Marketing Campaigns email for delivery at a specific time.

Schedule single send

Schedule a Single Send for immediate or future delivery.

Search contacts

Find 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 recipients

Search for recipients in the Legacy Marketing Campaigns contact database by field value.

Send a campaign

Immediately sends an existing marketing campaign to its configured recipients.

Send a test marketing email

Send a test marketing email before launching a campaign.

Send email with twilio sendgrid

The Mail Send operation uses SendGrid's v3 API to send emails.

Set up reverse dns

Set up reverse DNS (rDNS) for a dedicated IP address.

Start warming up an ip address

Put a dedicated IP address into warmup mode.

Stop warming up an ip address

Stop warming up a dedicated IP address and remove automatic sending limits.

Sum email stats for subusers

Retrieves summed email statistics for all subusers over a date range.

Test an Event Webhook's Settings

Sends 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 id

Enable or disable signature verification for a single Event Webhook by its ID.

Unlink subuser domain

Disassociate an authenticated domain from a subuser.

Unschedule a scheduled campaign

Unschedule a campaign that has already been scheduled to be sent.

Update a branded link

Update a specific branded link's default status.

Update a campaign

Updates an existing marketing campaign.

Update account offerings

Updates the offerings (email packages and add-ons) assigned to a customer account.

Update address whitelist mail settings

Updates the address whitelist mail settings for your SendGrid account.

Update a list

Updates the name of an existing recipient list in the Marketing Campaigns.

Update Account State

Update the state of a customer account using the Account Provisioning API.

Update an alert

Update an existing SendGrid alert's settings.

Update an authenticated domain

Updates the settings for an authenticated domain in SendGrid.

Update an IP Pool Name

Updates the name of an existing IP Pool in your SendGrid account.

Update an SSO Integration

Update an existing Single Sign-On (SSO) integration for your SendGrid account.

Update a parse setting

Updates an existing Inbound Parse Webhook setting by hostname.

Update API Key Name

Updates the name of an existing SendGrid API key.

Update api key name and scopes

Updates both the name and permission scopes of an existing SendGrid API key.

Update a scheduled campaign

Updates the scheduled send time for a Legacy Marketing Campaigns email.

Update a scheduled send

Update the status of a scheduled send batch that already has a pause or cancel status.

Update a segment

Updates an existing segment in SendGrid's Marketing Campaigns using the Segmentation V2 API.

Update a sender

Updates an existing Sender identity for use in SendGrid Marketing Campaigns.

Update a sender identity

Updates an existing sender identity in SendGrid.

Update a single event webhook by id

Updates the configuration of a specific Event Webhook by its ID.

Update a suppression group

Updates an existing suppression group (also known as an unsubscribe group).

Update a User's Profile

Updates the authenticated user's profile information in SendGrid.

Update bounce purge mail settings

Update your Bounce Purge mail settings in SendGrid.

Update click tracking settings

Updates click tracking settings for your SendGrid account.

Update custom field definition

Updates the name of an existing custom field in SendGrid Marketing Contacts.

Update design

Updates an existing email design in the SendGrid Design Library using PATCH.

Update details for an ip address

Updates settings for a dedicated IP address in your SendGrid account.

Update enforced tls settings

Update the Enforced TLS settings for your SendGrid account.

Update footer mail settings

Update your Footer mail settings in SendGrid.

Update forward bounce mail settings

Updates the forward bounce mail settings for your SendGrid account.

Update forward spam mail settings

Updates the Forward Spam mail settings for your SendGrid account.

Update Google Analytics Settings

Updates Google Analytics tracking settings for your SendGrid account.

Update Marketing Integration

Update an existing Marketing Integration by its unique ID.

Update list

Update the name of an existing contact list in SendGrid Marketing Campaigns.

Update open tracking settings

Updates open tracking settings for your SendGrid account.

Update single send

Update a Single Send draft by its ID.

Update SSO Certificate

Update an existing SSO (Single Sign-On) certificate by its ID.

Update subscription tracking settings

Updates subscription tracking settings for your SendGrid account.

Update Teammate's Permissions

Updates a teammate's permissions in your SendGrid account.

Update template mail settings

Updates the legacy email template mail settings for your SendGrid account.

Update the credits for a subuser

Update the credit allocation settings for a SendGrid Subuser.

Update the remaining credits for a subuser

Updates the remaining credits for a specific Subuser account by adding or subtracting from the current credit balance.

Update your account email address

Updates the email address currently on file for your SendGrid account.

Update your password

Update the password for your SendGrid account.

Update your username

Update the username for your SendGrid account.

Validate a batch ID

Validate 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 email

Validates an email address and returns a verdict on its validity.

Validate a reverse dns record

Validate a reverse DNS (rDNS) record to check if DNS is properly configured.

Verify sender request

Verifies a sender identity using a token from the verification email.

View a sender identity

Retrieves the details of a specific Legacy Sender Identity by its unique ID.

View scheduled time of a campaign

Retrieves the scheduled send date and time for a Legacy Marketing Campaign.

FAQ

Frequently asked questions

With a standalone Sendgrid MCP server, the agents and LLMs can only access a fixed set of Sendgrid tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Sendgrid and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Sendgrid tools.

Yes, absolutely. You can configure which Sendgrid scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Sendgrid data and credentials are handled as safely as possible.

Start with Sendgrid.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Sendgrid tool your agent needs.Free to start.

Start building