# SendGrid — MCP server on mcp.ai
> Connect your SendGrid account and use 364 tools for transactional email straight from your AI agent. Connect with your own API key. SendGrid is a cloud-based email delivery platform providing transactional and marketing email services, with APIs for integration, analytics, and scalability.

By: mcp.ai · official
Page: https://mcp.ai/sendgrid

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_sendgrid?ms=1787293740000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/sendgrid/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/sendgrid/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/sendgrid/skill.md
Postman collection (v2.1): https://mcp.ai/sendgrid/postman.json

## Tools
- sendgrid_activate_template_version(version_id: string, template_id: string) — Activates a specific version of a transactional template, making it the default version used when sending emails. Only one version can be active at a time per template. When you activate a version, an
- sendgrid_add_a_batch_of_ips_to_an_ip_pool(ips: string[], poolid: string) — Adds a batch of IP addresses to a specified IP Pool in SendGrid. This operation appends multiple IPs to an existing IP Pool. All IP assignments must succeed for the operation to complete - if any sing
- sendgrid_add_a_single_recipient_to_a_list(list_id: integer, recipient_id: string) — Adds a single recipient to a contact list in SendGrid's Legacy Contact Database. IMPORTANT: This uses the deprecated Legacy API (/v3/contactdb/). Many accounts no longer have access and will receive 4
- sendgrid_add_a_twilio_send_grid_ip_address(region?: string, subusers?: string[], include_region?: boolean, is_auto_warmup: boolean, is_parent_assigned: boolean) — Provisions a new Twilio SendGrid IP address to your account. This endpoint adds (purchases) a dedicated IP address to your SendGrid account. You can optionally: - Enable automatic warmup to gradually 
- sendgrid_add_an_ip_address_to_a_pool(ip: string, pool_name: string) — Adds a dedicated IP address to an IP pool in your SendGrid account. **Prerequisites:** - You must have a SendGrid Pro or Premier plan with dedicated IP addresses - The IP address must be activated in 
- sendgrid_add_an_ip_to_an_authenticated_domain(id: integer, ip: string) — Add an IP address to an authenticated domain for custom SPF configuration. This endpoint associates a dedicated IP address with an authenticated domain, which is useful for manually specifying IPs in 
- sendgrid_add_ips(count: integer, warmup?: boolean, subusers?: string[]) — Add dedicated IP addresses to your SendGrid account. This endpoint provisions new dedicated IP addresses for sending emails. Dedicated IPs give you full control over your sender reputation and are rec
- sendgrid_add_one_or_more_ips_to_the_allow_list(ips: object[]) — Adds one or more IPv4 addresses to your SendGrid account's IP access management allow list. Once enabled, only requests from these IPs can access SendGrid UI, API, and SMTP relay. Each IP is assigned 
- sendgrid_add_or_update_a_contact(contacts: object[], list_ids?: string[]) — Adds or updates contacts in SendGrid Marketing Campaigns. This is an asynchronous operation that queues contacts for processing. Returns a job_id to track the import status. Contacts are matched by id
- sendgrid_add_suppressions_to_a_suppression_group(group_id: string, recipient_emails: string[]) — **This endpoint allows you to add email addresses to an unsubscribe group.** If you attempt to add suppressions to a group that has been deleted or does not exist, the suppressions will be added to th
- sendgrid_add_to_global_suppressions_group(recipient_emails: string[]) — Adds one or more email addresses to the global suppression group. Email addresses added to this group will no longer receive any emails from your SendGrid account. This is useful for managing recipien
- sendgrid_approve_access_request(request_id: string) — **This endpoint allows you to approve an access attempt.** **Note:** Only teammate admins may approve another teammate’s access request.
- sendgrid_assign_a_batch_of_subusers_to_an_ip(ip: string, subusers: string[]) — Assigns multiple subusers to a specified IP address in a single operation. All subuser assignments must succeed; if any assignment fails, the entire operation returns an error. Requires IP Address Man
- sendgrid_associate_a_branded_link_with_a_subuser(link_id: integer, username: string) — Associate a branded link with a subuser account for email link tracking. This allows a subuser to use the parent account's branded link (link branding/ whitelabel) for link tracking in their emails, e
- sendgrid_associate_an_authenticated_domain_with_a_given_user(username: string, domain_id: integer) — Associate an authenticated domain with a subuser, allowing the subuser to send emails using the parent account's domain authentication. The parent account must first authenticate and validate the doma
- sendgrid_authenticate_a_domain(ips?: string[], domain: string, region?: string, default?: boolean, username?: string, subdomain?: string, custom_spf?: boolean, automatic_security?: boolean, custom_dkim_selector?: string) — 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 domai
- sendgrid_authenticate_an_account_with_single_sign_on(accountID: string) — Generates a one-time SSO authentication URL for logging into a customer's Twilio SendGrid account. IMPORTANT: This endpoint is only available to Twilio SendGrid reseller partners with a formal partner
- sendgrid_bind_authenticated_domains_to_user(username: string, domain_id: integer) — Associates an additional authenticated domain with a subuser. A subuser can have up to 5 authenticated domains linked to it. This endpoint is used to add domains beyond the first one (use 'Associate a
- sendgrid_bulk_delete_single_sends(ids: string[]) — Permanently deletes multiple Single Sends in a single operation by providing their IDs. You can delete up to 1000 Single Sends per request. Single Send IDs can be retrieved using the 'Get all single s
- sendgrid_cancel_or_pause_a_scheduled_send(status: string, batch_id: string) — Cancel or pause a group of scheduled email sends by their batch_id. Use 'pause' to temporarily hold sends (resumable via 'update_a_scheduled_send' or deletable via 'delete_a_cancellation_or_pause_from
- sendgrid_completed_steps() — Retrieves the verification status of a SendGrid account, checking if Domain Authentication and Single Sender Verification have been completed. Returns two boolean values: - `domain_verified`: True if 
- sendgrid_create_a_batch_id() — Generate a new mail batch ID to group multiple email sends together. The batch ID allows you to: - Group related email sends for bulk operations - Pause all scheduled sends associated with the batch I
- sendgrid_create_a_branded_link(domain: string, region?: string, default?: boolean, subdomain?: string) — Create a new branded link by specifying the root domain, which must align with your FROM email, and an optional unique subdomain. Subusers can request using the `on-behalf-of` header.
- sendgrid_create_a_campaign(title: string, editor?: string, ip_pool?: string, subject?: string, list_ids?: integer[], sender_id?: integer, categories?: string[], segment_ids?: integer[], html_content?: string, plain_content?: string, suppression_group_id?: integer, custom_unsubscribe_url?: string) — 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.
- sendgrid_create_a_custom_field(name: string, type: string) — Creates a custom field for storing additional contact information in SendGrid. Custom fields allow you to store additional data about your contacts beyond the default fields. You can create up to 120 
- sendgrid_create_a_list(name: string) — Create a new contact list in SendGrid's Marketing Campaigns. This endpoint creates a list that can be used to organize and segment your contacts for targeted email campaigns. Once created, you can add
- sendgrid_create_a_new_alert(type: string, email_to: string, frequency?: string, percentage?: integer) — Create a new SendGrid alert. Supports two alert types: - **usage_limit**: Notifies when email usage reaches a percentage threshold (requires `percentage` param). - **stats_notification**: Sends period
- sendgrid_create_a_new_event_webhook(url: string, open?: boolean, click?: boolean, bounce?: boolean, dropped?: boolean, enabled?: boolean, deferred?: boolean, delivered?: boolean, processed?: boolean, spam_report?: boolean, unsubscribe?: boolean, friendly_name?: string, oauth_client_id?: string, oauth_token_url?: string, group_resubscribe?: boolean, group_unsubscribe?: boolean, oauth_client_secret?: string) — Set up an Event Webhook by providing a URL, choosing events for POST requests, and receive a unique ID. After creation, you can add names, OAuth, and signature verification.
- sendgrid_create_a_new_suppression_group(name?: string, is_default?: boolean, description?: string) — Create a new suppression group (unsubscribe group) to allow recipients to opt out of specific types of emails. Suppression groups are specific categories of email (like newsletters, promotions, or ale
- sendgrid_create_a_new_transactional_template_version(name: string, active?: integer, editor?: string, subject: string, test_data?: string, template_id: string, html_content?: string, plain_content?: string, generate_plain_content?: boolean) — **This endpoint allows you to create a new version of a template.**
- sendgrid_create_a_parse_setting(url: string, hostname: string, send_raw?: boolean, spam_check?: boolean) — Creates a new Inbound Parse Webhook setting to receive and parse incoming emails. **Prerequisites:** 1. The hostname must be part of a domain that is authenticated via SendGrid Domain Authentication. 
- sendgrid_create_a_segment(name: string, list_id?: integer, conditions: object[]) — Creates a new segment in SendGrid's Contact Database (Legacy Marketing Campaigns). Segments group contacts based on specified conditions for targeted email campaigns. Conditions support various operat
- sendgrid_create_a_sender(zip?: string, city: string, state?: string, address: string, country: string, nickname: string, address_2?: string, from__name: string, from__email: string, reply__to__name?: string, reply__to__email: string) — Creates a new Sender identity for use in SendGrid Marketing Campaigns. You may create up to 100 unique Senders. Senders must be verified before use - if your domain is authenticated the Sender will au
- sendgrid_create_a_sender_identity(zip?: string, city: string, state?: string, address: string, country: string, nickname: string, address_2?: string, from__name: string, from__email: string, reply__to__name?: string, reply__to__email: string) — **Create a new sender identity in SendGrid.** A sender identity is required to send email through SendGrid. It represents the "from" information that recipients will see. You may create up to 100 uniq
- sendgrid_create_a_transactional_template(name: string, generation?: string) — Create a new transactional email template in SendGrid. Transactional templates allow you to create reusable email templates for sending transactional emails. Each account and subuser can create up to 
- sendgrid_create_an_account(offerings: object[], profile__email?: string, profile__phone?: string, profile__timezone?: string, profile__last__name?: string, profile__first__name?: string, profile__company__name?: string, profile__company__website?: string) — Creates a new customer account under your organization using the Account Provisioning API. IMPORTANT: This endpoint is only available to Twilio SendGrid reseller partners with a formal partnership agr
- sendgrid_create_an_ip_pool(name: string) — Creates a new IP pool in your SendGrid account. IP pools allow you to group your dedicated SendGrid IP addresses together. For example, you could create separate pools for transactional and marketing 
- sendgrid_create_an_ip_pool_with_a_name_and_ip_assignments(ips?: string[], name: string) — Creates a new IP Pool in your SendGrid account using the IP Address Management API. IP Pools allow you to group your dedicated SendGrid IP addresses together (e.g., separate pools for transactional vs
- sendgrid_create_an_sso_certificate(enabled?: boolean, integration_id: string, public_certificate: string) — Create an SSO certificate for SAML 2.0 Single Sign-On authentication. This endpoint creates an SSO certificate that allows SendGrid to verify SAML requests from your Identity Provider (IdP). The certi
- sendgrid_create_an_sso_integration(name: string, enabled: boolean, entity_id: string, signin_url: string, signout_url: string, completed_integration?: boolean) — Create a new Single Sign-On (SSO) integration for your SendGrid account. This endpoint allows you to configure SAML 2.0 SSO with your Identity Provider (IdP) such as Okta, Azure AD, or Duo. SSO enable
- sendgrid_create_an_sso_teammate(email: string, scopes?: string[], persona?: string, is_admin?: boolean, last_name: string, first_name: string, subuser_access?: object[], has_restricted_subuser_access?: boolean) — Creates a Single Sign-On (SSO) Teammate in SendGrid. SSO Teammates authenticate via your Identity Provider (IdP) instead of username/password. Requires: Enterprise SendGrid account with SSO integratio
- sendgrid_create_api_keys(name: string, scopes?: string[]) — Creates a new SendGrid API key with specified permissions. The first API key must be created in the SendGrid App UI; subsequent keys can be created via this endpoint. Limit: 100 keys per account. If n
- sendgrid_create_custom_field_definition(name: string, field_type: string) — Create unique case-insensitive custom fields with alphanumeric/underscore names starting with a letter/underscore. Save the ID for edits/deletes. Limited to 500 fields of type date, text, or number. A
- sendgrid_create_design(name?: string, editor?: string, html_content: string, plain_content?: string) — Creates a new email design in the SendGrid Design Library. The design can be used for Single Sends, Automations, and Dynamic Templates. Requires at minimum an html_content parameter with valid HTML. R
- sendgrid_create_integration(label?: string, destination: string, filters__email__events: string[], properties__write__key: string, properties__destination__region: string) — Create a SendGrid Marketing Integration for email event forwarding to Segment. This action creates an integration that automatically forwards specified email events (like opens, clicks, bounces, etc.)
- sendgrid_create_list(name: string) — Create a new contact list in SendGrid Marketing Campaigns. Lists are static collections of contacts used for organizing and targeting email campaigns. Once created, you can add contacts to the list us
- sendgrid_create_segment(name: string, query_dsl: string, parent_list_ids?: string[]) — Creates a new contact segment using SendGrid's Marketing Campaigns Segmentation V2 API. Segments allow you to group contacts based on SQL queries against contact data and engagement events. Segment na
- sendgrid_create_single_send(name: string, send_at?: string, categories?: string[], send__to__all?: boolean, send__to__list__ids?: string[], email__config__editor?: string, email__config__subject?: string, send__to__segment__ids?: string[], email__config__ip__pool?: string, email__config__design__id?: string, email__config__sender__id?: integer, email__config__html__content?: string, email__config__plain__content?: string, email__config__suppression__group__id?: integer, email__config__custom__unsubscribe__url?: string, email__config__generate__plain__content?: boolean) — The endpoint lets you create a Single Send draft without needing a template ID; it now uses `email_config`. A set `send_at` doesn't schedule it; it must be done through another endpoint or UI.
- sendgrid_create_subuser(ips: string[], email: string, region?: string, password: string, username: string, include_region?: boolean) — **This endpoint allows you to create a new subuser.** Subusers allow you to segment your email sending and API activity. They are typically available on Pro plans or above. Your API key must have prop
- sendgrid_create_verified_sender_request(zip: string, city: string, state: string, address: string, country: string, address2?: string, nickname: string, reply_to: string, from_name?: string, from_email: string, reply_to_name?: string) — This endpoint creates a new sender identity via `POST`, sends a verification email to `from_email`, and requires email verification. To resend, use `/resend/{id}`. For domain authentication, refer to 
- sendgrid_delete_a_batch_of_ips_from_an_ip_pool(ips: string[], poolid: string) — Removes a batch of IP addresses from a specified IP Pool in SendGrid. This operation unassigns the specified IPs from the pool but does NOT delete the IPs from your SendGrid account - they remain avai
- sendgrid_delete_a_batch_of_subusers_from_an_ip(ip: string, subusers: string[]) — Removes multiple subusers from a specified IP address in a single batch operation. This action unassigns subusers from an IP address, preventing them from sending email through that IP. This is useful
- sendgrid_delete_a_bounce(email: string) — Removes an email address from your SendGrid bounce suppression list. Use this to manually clear a bounced email, allowing future delivery attempts. Bounces occur when an email cannot be delivered due 
- sendgrid_delete_a_branded_link(id: integer) — Permanently delete a branded link from your SendGrid account. A successful deletion returns HTTP 204 No Content. The operation is irreversible - once deleted, the branded link cannot be recovered. If 
- sendgrid_delete_a_campaign(campaign_id: integer) — Permanently deletes a specific marketing campaign from your SendGrid account. **Note**: This endpoint is part of the Legacy Marketing Campaigns API. The campaign cannot be recovered once deleted. Ensu
- sendgrid_delete_a_contact_identifier(contact_id: string, identifier_type: string, identifier_value: string) — Removes a specific identifier (EMAIL, PHONENUMBERID, EXTERNALID, or ANONYMOUSID) from a contact without deleting the entire contact. The operation runs asynchronously and returns a job_id to track pro
- sendgrid_delete_a_custom_field(custom_field_id: integer) — Permanently deletes a custom field from your SendGrid contact database. **Important:** - This uses the Legacy Marketing Campaigns Contacts API - Only custom fields can be deleted; reserved fields cann
- sendgrid_delete_a_global_suppression(email: string) — This endpoint removes an email from suppressions, allowing future emails to be sent to it. Use with consent or bypass filters for one-off emails.
- sendgrid_delete_a_parse_setting(hostname: string) — Deletes a specific inbound parse webhook setting by hostname. **Use Case:** Remove an inbound parse configuration when you no longer want SendGrid to receive and process emails for a particular hostna
- sendgrid_delete_a_recipient(recipient_id: string) — **[LEGACY API - DEPRECATED]** Deletes a single recipient from the Legacy Marketing Campaigns contact database. This endpoint is part of SendGrid's deprecated Contact Database API (contactdb) and is NO
- sendgrid_delete_a_reverse_dns_record(id: string) — This endpoint deletes a reverse DNS record, returning a 204 code on success. Retrieve record IDs using the "Retrieve all reverse DNS records" endpoint.
- sendgrid_delete_a_segment(segment_id: integer, delete_contacts?: boolean) — Permanently deletes a segment from the SendGrid Contact Database (Legacy Marketing Campaigns). This endpoint allows you to delete a segment from your recipients database. You also have the option to d
- sendgrid_delete_a_sender(id: integer) — Permanently delete an existing Marketing Campaigns Sender identity from your SendGrid account. Senders are the 'from' addresses (sender identities) used in Marketing Campaigns emails. This endpoint re
- sendgrid_delete_a_sender_identity(sender_id: integer) — Permanently deletes a sender identity from your SendGrid account. **Important:** This action is irreversible. The deleted sender identity cannot be recovered. Sender identities are used for marketing 
- sendgrid_delete_a_single_event_webhook_by_id(id: string) — Delete a specific Event Webhook by ID with this endpoint. Unlike other endpoints which default to the oldest webhook, this requires an ID, else it errors to prevent accidental deletions. To disable, n
- sendgrid_delete_a_single_recipient_from_a_single_list(list_id: integer, recipient_id: string) — Remove a single recipient from a SendGrid contact list. This endpoint is part of the Legacy Marketing Campaigns API (contactdb). Note: This API has been deprecated by SendGrid and may not be available
- sendgrid_delete_a_specific_block(email: string, on-behalf-of?: string) — Deletes a specific email address from your SendGrid blocks list. Blocked emails are addresses that have been rejected by a receiving server or flagged for issues like ISP blocking, content filtering, 
- sendgrid_delete_a_specific_invalid_email(email: string) — Removes a specific email address from SendGrid's invalid emails suppression list. Invalid emails are addresses that are formatted incorrectly according to internet email standards or do not exist at t
- sendgrid_delete_a_specific_spam_report(email: string) — Removes a specific spam report from SendGrid's suppression list by email address. When an email recipient marks your message as spam, SendGrid adds their email to the spam reports suppression list to 
- sendgrid_delete_a_subuser(subuser_name: string) — Permanently delete a subuser from your SendGrid account. **WARNING**: This is a permanent, irreversible action. Once deleted, the subuser account cannot be retrieved and all access to Twilio SendGrid 
- sendgrid_delete_a_suppression_from_a_suppression_group(email: string, group_id: string) — Remove an email address from a suppression group (unsubscribe group). This re-enables email delivery to the specified address for the given group. Use this only when recipients explicitly opt back in 
- sendgrid_delete_a_suppression_group(group_id: string) — This API endpoint deletes email suppression groups. Deleted group members get globally suppressed if they unsubscribe. Use with caution, only if recipients want to resubscribe. Bypass filters availabl
- sendgrid_delete_a_template(template_id: string) — Permanently deletes a transactional template from your SendGrid account. **Important:** This action is irreversible. The deleted template and all its versions cannot be recovered. Ensure the template 
- sendgrid_delete_a_transactional_template_version(version_id: string, template_id: string) — **Delete a specific version of a transactional template.** This endpoint permanently removes a template version. Once deleted, the version cannot be recovered. If you want to delete all versions of a 
- sendgrid_delete_an_account(accountID: string) — Permanently deletes a customer account under your organization using the Account Provisioning API. **WARNING:** This action is IRREVERSIBLE and will: - Revoke all API keys and SSO access (user can no 
- sendgrid_delete_an_alert(alert_id: integer) — Delete a SendGrid alert by its ID. Permanently removes an alert from your account. Alerts allow you to receive notifications regarding email usage or statistics: - **Usage alerts**: Notify when email 
- sendgrid_delete_an_authenticated_domain(domain_id: string) — Delete an authenticated domain (formerly known as domain whitelabel) by its ID. Deleting an authenticated domain removes the domain authentication, which means recipients may see 'via sendgrid.net' or
- sendgrid_delete_an_ip_pool(pool_name: string) — Delete an IP pool by its name using the legacy IP Pools API. IP pools allow you to group your dedicated SendGrid IP addresses together. For example, you could create separate pools for transactional a
- sendgrid_delete_an_sso_certificate(cert_id: string) — Delete an SSO certificate by its unique identifier. This endpoint permanently removes an SSO (Single Sign-On) certificate from your SendGrid account. SSO certificates are used to verify SAML requests 
- sendgrid_delete_an_sso_integration(id: string) — Delete an SSO (Single Sign-On) integration by ID. This endpoint permanently removes an IdP (Identity Provider) configuration from your SendGrid account. Once deleted, users will no longer be able to a
- sendgrid_delete_api_keys(api_key_id: string) — **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. If the API Key ID does not 
- sendgrid_delete_blocks(emails?: string[], delete_all?: boolean) — Delete blocked email addresses from your SendGrid suppression list. Blocked emails are addresses that have been rejected by the receiving server. This endpoint provides two ways to delete blocks: 1. D
- sendgrid_delete_bounces(emails?: string[], delete_all?: boolean) — Delete bounced email addresses from your SendGrid bounce suppression list. Use this action to remove email addresses from your bounce list, allowing you to attempt sending to them again. You can eithe
- sendgrid_delete_bulk_integration(ids: string[]) — Bulk delete multiple Integrations by providing their IDs as a query parameter. Integrations are used for email event forwarding to third-party applications (e.g., Segment). Integration IDs can be retr
- sendgrid_delete_cancellation_or_pause_from_scheduled_send(batch_id: string) — Resume a paused or cancelled scheduled send by removing its pause/cancel status. This action deletes the cancellation or pause status from a batch of scheduled sends, effectively resuming them. Use th
- sendgrid_delete_contacts(ids?: string, delete_all_contacts?: string) — Deletes contacts from your SendGrid Marketing Campaigns account. This is a destructive, irreversible operation. Deletions are processed asynchronously - a job_id is returned immediately that can be us
- sendgrid_delete_custom_field_definition(custom_field_id: string) — Permanently deletes a custom field definition from SendGrid Marketing Campaigns. **Important notes:** - Only custom fields can be deleted; reserved fields (first_name, last_name, email, etc.) cannot b
- sendgrid_delete_design(id: string) — **This endpoint allows you to delete a single design**. Be sure to check the ID of the design you intend to delete before making this request; deleting a design is a permanent action.
- sendgrid_delete_invalid_emails(emails?: string[], delete_all?: boolean) — Delete email addresses from your SendGrid invalid emails suppression list. Invalid emails are addresses that have hard bounced or have been identified as invalid. Removing addresses from this list all
- sendgrid_delete_ip_pool(poolid: string) — Delete an IP Pool from your SendGrid account using the IP Address Management API. This operation permanently deletes the specified IP Pool and automatically unassigns all IP addresses that were associ
- sendgrid_delete_pending_teammate(token: string) — Delete a pending teammate invitation that hasn't yet been accepted. This endpoint cancels an outstanding invitation to join your SendGrid account as a teammate. Teammate invitations expire after 7 day
- sendgrid_delete_single_send_by_id(id: string) — Permanently deletes a Single Send by its unique ID. You can obtain the Single Send ID from the GET `/v3/marketing/singlesends` endpoint or the SendGrid Marketing Campaigns UI. Warning: This deletion i
- sendgrid_delete_single_send_schedule(id: string) — Cancel a scheduled Single Send by deleting its scheduled send time. This action removes the schedule but preserves the Single Send as a draft - all campaign content (subject, body, recipients, etc.) r
- sendgrid_delete_spam_reports(emails?: string[], delete_all?: boolean) — Delete spam reports from your SendGrid spam report suppression list. Use this action to remove email addresses from your spam reports list, allowing you to attempt sending to them again. You can eithe
- sendgrid_delete_teammate(username: string) — Permanently delete a teammate from your SendGrid account. This endpoint removes a teammate's access to your account. Only the parent user or an admin teammate can delete another teammate. This action 
- sendgrid_delete_verified_sender(id: string) — Deletes a Verified Sender Identity from your SendGrid account. Use this endpoint to permanently remove a Verified Sender by providing its unique `id`. You can find Sender Identity IDs by using the "Ge
- sendgrid_deny_access_request(request_id: string) — Denies a teammate's pending access request. This action removes the request without granting the requested permissions. Only teammate admins can deny access requests. Use this to reject requests from 
- sendgrid_disassociate_a_branded_link_from_a_subuser(username: string) — Remove a branded link association from a subuser account. This endpoint allows parent accounts to disassociate a branded link from a subuser. After disassociation, the subuser will no longer be able t
- sendgrid_domain_warn_list() — Retrieves a list of domains known to implement DMARC (Domain-based Message Authentication, Reporting & Conformance) policies, categorized by failure type. DMARC failures affect email deliverability: -
- sendgrid_download_csv(download_uuid: string) — Retrieves a presigned S3 URL to download a CSV file of email activity data (up to 1M events, last 30 days). **Workflow:** 1. Use SENDGRID_REQUEST_CSV to initiate CSV generation 2. Wait for SendGrid em
- sendgrid_duplicate_a_transactional_template(name?: string, template_id: string) — Duplicate an existing transactional template to create a new template with the same content. Each parent account and Subuser can create up to 300 different transactional templates. Templates are speci
- sendgrid_duplicate_design(id: string, name?: string, editor?: string) — Duplicates an existing email design in the SendGrid Design Library. Creates a copy of the specified design with a new unique ID. The duplicate can be customized with a new name, otherwise it will be n
- sendgrid_duplicate_send_grid_pre_built_design(id: string, name?: string, editor?: string) — Duplicates a pre-built SendGrid email design template from the SendGrid Design Library. Pre-built designs are professionally designed email templates provided by SendGrid that can be duplicated and cu
- sendgrid_duplicate_single_send(id: string, name?: string) — Duplicates an existing Single Send by its ID, creating a new draft that can be edited via the Update Single Send endpoint (PATCH). The duplicate inherits all settings from the original including email
- sendgrid_edit_a_transactional_template(name?: string, template_id: string) — Updates the name of an existing transactional template. This endpoint allows you to rename a transactional template without affecting its content or versions. To modify the actual template content (HT
- sendgrid_edit_a_transactional_template_version(name?: string, active?: integer, editor?: string, subject?: string, test_data?: string, version_id: string, template_id: string, html_content?: string, plain_content?: string, generate_plain_content?: boolean) — Edit a transactional template version in SendGrid. This endpoint allows you to update the content, subject, name, and other properties of an existing template version. Use this to modify email templat
- sendgrid_edit_an_sso_teammate(scopes?: string[], persona?: string, is_admin?: boolean, username: string, last_name?: string, first_name?: string, subuser_access?: object[], has_restricted_subuser_access?: boolean) — Updates an existing SSO Teammate's permissions and profile in SendGrid. **Requirements**: Enterprise SendGrid account with SSO integration enabled. Only parent users or Teammates with admin permission
- sendgrid_edit_verified_sender(id: string, zip?: string, city?: string, state?: string, address?: string, country?: string, address2?: string, nickname?: string, reply_to?: string, from_name?: string, from_email?: string, reply_to_name?: string) — Updates an existing verified sender identity in SendGrid. This action allows partial updates - only the fields you specify will be modified, while all other fields remain unchanged. Use this to update
- sendgrid_email_dns_records_to_a_co_worker(email: string, link_id?: integer, message?: string, domain_id?: integer) — Email DNS records to a co-worker for domain authentication or link branding setup. This action sends an email containing the DNS records needed to configure domain authentication (DKIM, SPF) or link b
- sendgrid_enable_disable_a_subuser(disabled: boolean, subuser_name: string) — Enable or disable a SendGrid subuser account. Use this endpoint to control whether a subuser can send emails: - Set `disabled=true` to disable the subuser (prevents email sending) - Set `disabled=fals
- sendgrid_enable_disable_website_access_for_a_subuser(disabled: boolean, subuser_name: string) — Enable or disable website portal access for a SendGrid subuser while preserving their email sending capabilities. Use this to control whether a subuser can log into the SendGrid web interface without 
- sendgrid_erase_recipients_email_data(email_addresses: string[]) — Permanently erases recipients' personal email data from SendGrid for GDPR/privacy compliance. This operation removes PII (names, email addresses, subject lines, categories, IP addresses) for up to 5,0
- sendgrid_export_contacts(list_ids?: string[], file_type?: string, segment_ids?: string[], max_file_size?: integer, notifications__email?: boolean) — Initiates an asynchronous job to export Marketing Campaigns contacts to CSV or JSON. **Use Cases:** - Export all contacts from your SendGrid Marketing Campaigns database - Export contacts from specifi
- sendgrid_export_contacts_status(id: string) — Retrieves the status of a contact export job and provides download URLs when ready. Use this endpoint with an export job ID (returned by the 'Export Contacts' endpoint) to check the export status and 
- sendgrid_export_single_send_stats(ids?: string[], timezone?: string) — Exports Single Send campaign statistics in CSV format. This endpoint allows you to export stats for one or more Single Sends from SendGrid Marketing Campaigns. The exported CSV data includes engagemen
- sendgrid_filter_all_messages(limit?: integer, query: string) — Filter and retrieve email activity from the SendGrid Email Activity Feed API. This action queries email messages sent through SendGrid and returns activity data based on the provided filter criteria. 
- sendgrid_filter_messages_by_message_id(msg_id: string) — Retrieve detailed information about a specific email message by its unique message ID. This endpoint returns comprehensive details including sender, recipient, subject, delivery status, template ID, a
- sendgrid_get_a_contact_by_id(id: string) — Retrieves the full details of a single contact by their unique ID from SendGrid Marketing Campaigns. Returns all standard fields (email, name, address, etc.) and any custom fields defined for the cont
- sendgrid_get_a_list_of_all_ip_addresses_on_your_account(ip?: string, pool?: string, limit?: integer, region?: string, after_key?: integer, is_leased?: boolean, before_key?: string, is_enabled?: boolean, end_added_at?: integer, include_region?: boolean, start_added_at?: integer, is_parent_assigned?: boolean) — Fetches your account's IP addresses with details such as pool association and warm-up status. 'is_parent_assigned' and 'pool' must be exclusive. Pagination needs 'limit' and 'before_key' or 'after_key
- sendgrid_get_a_list_of_all_senders(id?: integer, limit?: integer, lastSeenID?: integer) — Retrieves a list of all Sender identities associated with your SendGrid account. Sender identities are used in Marketing Campaigns to define the 'from' information for your emails. This endpoint suppo
- sendgrid_get_a_list_of_subusers_assigned_to_an_ip(ip: string, limit?: integer, after_key?: integer) — Retrieves a list of Subuser IDs assigned to a specific IP address in your SendGrid account. Returns up to 100 subuser IDs per request. Use pagination parameters ('after_key' and 'limit') to iterate th
- sendgrid_get_a_specific_sender(id: integer) — Retrieves the details of a specific Marketing Sender by its unique ID. Returns comprehensive sender information including: - Sender identification (ID, nickname) - Email configuration (from email/name
- sendgrid_get_a_user_s_account_information() — Retrieves the authenticated user's SendGrid account details including account type (e.g., 'free', 'paid') and sender reputation score (0-100). This is a read-only endpoint that requires no parameters.
- sendgrid_get_a_user_s_profile() — Retrieve the authenticated user's profile details. This endpoint returns the current user's profile information including their name, contact details, company, and address. No parameters are required 
- sendgrid_get_account_offerings(accountID: string) — Retrieves the offerings (email packages and add-ons) assigned to a specific customer account. IMPORTANT: This endpoint is part of the Account Provisioning API and is only available to Twilio SendGrid 
- sendgrid_get_all_accounts(limit?: integer, offset?: string) — Retrieves all accounts under the organization.
- sendgrid_get_all_automation_stats(page_size?: integer, page_token?: string, automation_ids?: string[]) — Retrieve email statistics for SendGrid Marketing Automations (automated email workflows). Returns performance metrics including delivery rates, opens, unique_opens, clicks, unique_clicks, bounces, uns
- sendgrid_get_all_available_offerings() — Retrieves all available SendGrid offerings for account provisioning. This is a Partner/Reseller API endpoint that lists all the SendGrid product offerings that can be assigned to customer accounts. Th
- sendgrid_get_all_categories() — Retrieve all categories associated with your Marketing Campaigns Single Sends. This endpoint returns up to your latest 1,000 categories that have been used to organize and tag your Single Sends in Sen
- sendgrid_get_all_existing_exports() — Retrieves all existing contact export jobs from SendGrid Marketing Campaigns. Returns an array of export jobs with their status, type, creation/completion timestamps, and download URLs for ready expor
- sendgrid_get_all_field_definitions() — Retrieve all field definitions including custom and reserved fields from Marketing Campaigns. This action returns complete information about all field definitions in your SendGrid account: - **Custom 
- sendgrid_get_all_ip_pools_that_have_associated_ips(ip?: string, limit?: integer, region?: string, after_key?: integer, include_region?: boolean) — The function lists your IP Pools and samples up to 10 IPs from each. For more IPs per pool, use "Get IPs Assigned to an IP Pool." Max of 100 IP Pools per user.
- sendgrid_get_all_sender_identities() — **This endpoint allows you to retrieve a list of all sender identities that have been created for your account.**
- sendgrid_get_all_single_sends(page_size?: integer, page_token?: string) — Retrieve a list of your Single Sends with brief details, including their IDs. For in-depth information on a specific Single Send, use its ID at the `/marketing/singlesends/{id}` endpoint.
- sendgrid_get_all_single_sends_stats(page_size?: integer, page_token?: string, singlesend_ids?: string[]) — Retrieve email statistics for SendGrid Single Sends (one-time marketing email campaigns). Returns performance metrics including delivery rates, opens, clicks, bounces, and unsubscribes for each Single
- sendgrid_get_all_sso_certificates_by_integration(integration_id: string) — Retrieves all SSO (Single Sign-On) certificates associated with a specific IdP integration. The `integration_id` parameter should be obtained from the 'Get All SSO Integrations' endpoint. Each certifi
- sendgrid_get_all_sso_integrations(si?: boolean) — **This endpoint allows you to retrieve all SSO integrations tied to your Twilio SendGrid account.** The IDs returned by this endpoint can be used by the APIs additional endpoints to modify your SSO in
- sendgrid_get_all_verified_senders(id?: integer, limit?: integer, lastSeenID?: integer) — Retrieve all Sender Identities (verified/unverified) for an account via an endpoint. Customize results using `limit`, `lastSeenID`, and `id` parameters to define the results scope.
- sendgrid_get_an_account_s_state(accountID: string) — Retrieve the current state of a customer account using the Account Provisioning API. IMPORTANT: This endpoint is only available to Twilio SendGrid reseller partners with a formal partnership agreement
- sendgrid_get_an_sso_certificate(cert_id: string) — Retrieve an individual SSO certificate by its ID. SSO (Single Sign-On) certificates are X509 certificates used by SendGrid to verify that SAML requests are coming from your Identity Provider (IdP) suc
- sendgrid_get_an_sso_integration(id: string, si?: boolean) — **This endpoint allows you to retrieve an SSO integration by ID.** You can retrieve the IDs for your configurations from the response provided by the "Get All SSO Integrations" endpoint.
- sendgrid_get_automation_click_tracking_stats_by_id(id: string, group_by?: string[], step_ids?: string[], page_size?: integer, page_token?: string) — Retrieve click-tracking statistics for a specific SendGrid Marketing Automation. Returns detailed link click statistics including the URL of each link, its position in the email, and the total number 
- sendgrid_get_automation_stats_by_id(id: string, end_date?: string, group_by?: string[], step_ids?: string[], timezone?: string, page_size?: integer, page_token?: string, start_date?: string, aggregated_by?: string) — 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.
- sendgrid_get_batched_contacts_by_ids(ids: string[]) — Retrieves multiple SendGrid Marketing Contacts by their IDs in a single batch request. This is more efficient than making individual GET requests when you need to fetch multiple contacts at once. You 
- sendgrid_get_bounce_class_stats(end_date?: string, start_date?: string, classification: string) — Retrieve daily bounce statistics filtered by a specific classification type. Returns the number of bounces for the specified classification (e.g., 'Invalid Address', 'Reputation', 'Technical Failure')
- sendgrid_get_bulk_validation_job(job_id: string) — Retrieves the details of a specific Bulk Email Address Validation Job by its ID. Use this endpoint to check the status and progress of a bulk email validation job. You can track whether a job is pendi
- sendgrid_get_contacts_by_emails(emails: string[]) — Search for Marketing Campaigns contacts by their email addresses. This endpoint retrieves up to 100 contacts matching the provided emails, with case-insensitive matching that ignores whitespace. Retur
- sendgrid_get_contacts_by_identifiers(identifiers: string[], identifier_type: string) — Retrieves up to 100 Marketing Campaigns contacts by searching for specific identifier values. Choose one identifier_type (email, phone_number_id, external_id, or anonymous_id) and provide a list of va
- sendgrid_get_design(id: string) — Retrieves a specific design's details from your Design Library by its ID. Returns the full design object including HTML content, plain text content, editor type, timestamps, and thumbnail URL. Useful 
- sendgrid_get_details_for_an_ip_address(ip: string, include_region?: boolean) — Retrieves detailed information about a specific IP address on your SendGrid account. Returns information including: - Parent assignment status (whether the parent can send mail from this IP) - Automat
- sendgrid_get_details_for_an_ip_pool(poolid: string, include_region?: boolean) — This operation retrieves details of an IP Pool, such as name, ID, some sample IPs (up to 10), and the total IP count. For more IPs, use "Get IPs Assigned to an IP Pool."
- sendgrid_get_email_suppression_groups(email: string) — **Retrieve all suppression groups for a specific email address.** This endpoint returns a list of all suppression groups in your SendGrid account, along with the suppression status of the specified em
- sendgrid_get_engagement_quality_scores(to: string, from: string) — Retrieve SendGrid Engagement Quality (SEQ) scores for a specified date range. SEQ is a composite deliverability score (1-5) based on engagement metrics from mailbox providers. Higher scores indicate b
- sendgrid_get_geo_stats(limit?: integer, offset?: integer, country?: string, end_date?: string, start_date: string, aggregated_by?: string) — Retrieves email engagement statistics (opens, clicks) segmented by geographic location (country and state/province). Currently supports US and Canada statistics only. Use this endpoint to analyze how 
- sendgrid_get_information_on_a_single_suppression_group(group_id: string, on-behalf-of?: string) — Retrieves details for a single suppression group (also known as an unsubscribe group). A suppression group allows recipients to unsubscribe from specific types of emails (e.g., newsletters, alerts) ra
- sendgrid_get_integration(id: string) — Retrieve a specific Marketing Integration by its unique ID. An Integration is a connection from SendGrid Marketing Campaigns to a supported third-party application (currently only Segment is supported
- sendgrid_get_ip_warmup_status(ip_address: string) — Retrieve the warmup status for a specific dedicated IP address. IP warmup is the process of gradually increasing email sending volume through a new IP to build sender reputation. This endpoint returns
- sendgrid_get_ips_assigned_to_an_ip_pool(limit?: integer, poolid: string, after_key?: integer, include_region?: boolean) — Retrieves IP addresses assigned to a specific IP Pool. This endpoint is part of the IP Address Management API (beta) and requires dedicated IP addresses and appropriate API permissions. The response i
- sendgrid_get_list_contact_count(id: string) — Retrieve the contact count and billable contact count for a specific marketing list. Returns both the total number of contacts currently stored in the list and the number of billable contacts (those t
- sendgrid_get_list_of_segments(ids?: string[], parent_list_ids?: string, no_parent_list_id?: boolean) — Retrieves a filtered list of contact segments from SendGrid Marketing Campaigns V2. Segments group contacts based on SQL queries for targeted email campaigns. Use filters to retrieve specific segments
- sendgrid_get_open_tracking_settings() — Retrieves the current open tracking settings for your SendGrid account. Open tracking works by inserting an invisible image (tracking pixel) at the end of HTML emails. When a recipient opens the email
- sendgrid_get_recipient_upload_status() — Retrieves the upload status for recipients in the Legacy Marketing Campaigns contacts database (contactdb). Use this endpoint to monitor the progress of recipient data being processed after bulk uploa
- sendgrid_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.**
- sendgrid_get_sample_contacts() — Retrieves a sample of up to 50 contacts from your Marketing Contacts database, sorted by email address. Includes the total contact count. This endpoint is useful for quickly previewing contacts withou
- sendgrid_get_send_grid_pre_built_design(id: string) — Retrieves details of a specific SendGrid pre-built design template by ID. Pre-built designs are professional email templates provided by SendGrid that you can duplicate and customize. Use this to insp
- sendgrid_get_signed_event_webhook_s_public_key(id: string) — Retrieves the public key for a specific Event Webhook by ID. The public key is used to verify the signature of incoming webhook requests (found in the X-Twilio-Email-Event-Webhook-Signature header). U
- sendgrid_get_single_send_by_id(id: string) — **This endpoint allows you to retrieve details about one Single Send using a Single Send ID.** You can retrieve all of your Single Sends by making a GET request to the `/marketing/singlesends` endpoin
- sendgrid_get_single_send_click_tracking_stats_by_id(id: string, group_by?: string[], page_size?: integer, page_token?: string, ab_phase_id?: string, ab_variation_id?: string) — **This endpoint lets you retrieve click-tracking stats for one Single Send**. The stats returned list the URLs embedded in the specified Single Send and the number of clicks each one received.
- sendgrid_get_single_send_stats_by_id(id: string, end_date?: string, group_by?: string[], timezone?: string, page_size?: integer, page_token?: string, start_date?: string, aggregated_by?: string) — Retrieve individual Single Send stats using its ID. For multiple IDs, use "Get All Single Sends Stats". Filter results by date or refine with `group_by` and `aggregated_by` parameters.
- sendgrid_get_single_sends_search(name?: string, status?: string[], page_size?: integer, categories?: string[], page_token?: string) — Search for Single Sends (marketing email campaigns) by name, status, and/or categories. Use this endpoint to find specific Single Sends when you have many campaigns. - Search by name using partial/wil
- sendgrid_get_subuser_monthly_stats(date: string, limit?: integer, offset?: integer, subuser_name: string, sort_by_metric?: string, sort_by_direction?: string) — Retrieves monthly email statistics for a specific subuser. Returns metrics such as blocks, bounces, clicks, delivered emails, opens, requests, unique clicks/opens, and unsubscribes. **Note**: This end
- sendgrid_get_subusers_engagement_quality_scores(date: string, limit?: integer, after_key?: integer) — Retrieve SendGrid Engagement Quality (SEQ) scores for all subusers on a specific date. Returns engagement scores (1-5 scale, higher is better) that measure email deliverability based on recipient enga
- sendgrid_get_suppression_groups(id?: integer) — 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 `?id=123456`.
- sendgrid_get_teammate_subuser_access(limit?: integer, username?: string, teammate_name: string, after_subuser_id?: integer) — Retrieve Subusers accessible to a specified Teammate, including their permission levels and scopes. Admin Teammates have access to all Subusers. For restricted Teammates, only returns Subusers they ha
- sendgrid_get_the_credits_for_a_subuser(subuser_name: string) — 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 cr
- sendgrid_get_the_default_authentication(domain?: string) — Retrieves the default domain authentication configuration for your SendGrid account. The default domain is used to send all mail unless overridden by a matching authenticated domain for the 'From' add
- sendgrid_get_the_settings_for_a_single_event_webhook(id: string, include?: string) — Retrieves the configuration and settings for a single Event Webhook by its ID. Returns the webhook URL, enabled status, subscribed event types (bounce, click, delivered, open, etc.), and OAuth/signatu
- sendgrid_get_total_contact_count() — Retrieve the total number of contacts stored in your SendGrid Marketing Campaigns account. This endpoint returns: - The total contact count across all lists and segments - The billable contact count f
- sendgrid_get_user_scopes() — Retrieve a list of scopes for which this user has access
- sendgrid_import_contacts(list_ids?: string[], file_type: string, field_mappings: string[]) — Initiates a bulk contact import by requesting an upload URL for a CSV file. This is step 1 of a two-step process: 1. Call this action with field mappings to get an upload_uri and upload_headers 2. PUT
- sendgrid_import_contacts_status(id: string) — Check the status of a contact import, update, or delete job in SendGrid Marketing Campaigns. Use this endpoint to monitor asynchronous contact operations by providing the job_id returned from contact 
- sendgrid_invite_teammate(email: string, scopes: string[], is_admin?: boolean) — Invite teammates to your account through email with this endpoint, assigning initial permissions via the `scopes` array. Invites expire after 7 days but can be resent.
- sendgrid_list_all_authenticated_domains(limit?: integer, domain?: string, offset?: integer, username?: string, exclude_subusers?: boolean) — Retrieve authenticated domain lists in pages using the `limit` parameter for page size and `offset` to start from specific list positions. Multiple requests handle large lists.
- sendgrid_list_all_subusers(limit?: integer, offset?: integer, region?: string, username?: string, include_region?: boolean) — Retrieve a paginated list of subusers with filtering options. Use `username` to filter, `limit` to set page size, and `offset` to navigate through the list.
- sendgrid_list_api_keys(limit?: integer) — Retrieve user's API key names and IDs with this endpoint; keys themself cannot be retrieved for security. Lost keys require recreation. Use 'api_key_id' to manage keys.
- sendgrid_list_bulk_email_validation_jobs() — Retrieves a list of all Bulk Email Address Validation Jobs for the account. Bulk Email Validation allows you to upload a CSV file with up to 1 million email addresses to be validated asynchronously. E
- sendgrid_list_designs(summary?: boolean, page_size?: integer, page_token?: string) — List designs from the Design Library. Fetches user-created designs stored in the SendGrid Design Library (part of Marketing Campaigns). Returns up to 100 designs per request by default, with paginatio
- sendgrid_list_integration() — This endpoint returns all the Integrations for the user making this call.
- sendgrid_list_send_grid_pre_built_designs(summary?: boolean, page_size?: integer, page_token?: string) — 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`. Useful for dupli
- sendgrid_list_user_auth_domains(username: string) — Retrieves all authenticated domains that have been assigned to a specific subuser. Authenticated domains allow subusers to send email using their parent account's domain authentication. Requires the '
- sendgrid_manually_refresh_a_segment(segment_id: string, user_time_zone: string) — Manually refresh a Marketing Campaigns V2 segment to update its contact membership. This endpoint triggers an immediate refresh of the segment's contact list based on its query criteria. Normally, Sen
- sendgrid_presigned_url_headers_for_bulk_email_validation(file_type?: string) — Request a presigned URL and headers to upload a file containing email addresses for bulk validation. This endpoint returns an upload URL (upload_uri), request headers (upload_headers), and a job ID (j
- sendgrid_remove_a_specific_ip_from_the_allowed_list(rule_id: string) — Removes a specific IP address from your SendGrid account's allow list. Use this to revoke access for an IP. Get the rule_id from the 'Retrieve a list of currently allowed IPs' endpoint. WARNING: Remov
- sendgrid_remove_an_ip_address_from_a_pool(ip: string, pool_name: string) — Remove an IP address from an IP pool in your SendGrid account. This endpoint allows you to disassociate a dedicated IP address from an IP pool. After removal, the IP address will no longer be used whe
- sendgrid_remove_an_ip_from_an_authenticated_domain(id: integer, ip: string) — Remove an IP address from an authenticated domain's custom SPF configuration. This endpoint dissociates a dedicated IP address from an authenticated domain, which is useful when you no longer want tha
- sendgrid_remove_contacts_from_a_list(id: string, contact_ids: string) — Remove contacts from a marketing list without deleting them from your account. This endpoint allows you to remove one or more contacts from a specified list. The contacts will not be deleted from your
- sendgrid_remove_list_and_optional_contacts(id: string, delete_contacts?: boolean) — Delete a marketing list from your SendGrid account. This endpoint permanently removes a specific list from your Marketing Campaigns. When delete_contacts is false (default), only the list is deleted a
- sendgrid_remove_one_or_more_ips_from_the_allow_list(ids: integer[]) — Removes one or more IP addresses from your SendGrid IP Access Management allow list. This endpoint accepts an array of IP rule IDs (integers) obtained from listing allowed IPs or from the response whe
- sendgrid_remove_segment_without_affecting_contacts(segment_id: string) — Permanently deletes a segment from SendGrid's Marketing Campaigns without affecting contacts. This endpoint removes only the segment definition - all contacts that were members of this segment remain 
- sendgrid_remove_user_domain(username: string) — Disassociate ALL authenticated domains from a subuser. This endpoint removes any authenticated domain associations that have been assigned to the specified subuser. After this operation, the subuser w
- sendgrid_rename_an_ip_pool(name: string, pool_name: string) — Renames an existing IP pool in your SendGrid account. IP pools allow you to group your dedicated SendGrid IP addresses together. For example, you might have separate pools for 'transactional' and 'mar
- sendgrid_request_csv(query?: string) — 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. Limited to one request per 12 hours, it's similar to the 
- sendgrid_resend_a_sender_verification(id: integer) — Resends the verification email for a Marketing Campaigns Sender identity. Use this when the original verification email was lost, expired, or needs to be resent. The sender must have been created via 
- sendgrid_resend_sender_identity_verification(sender_id: integer) — Resends the verification email to a sender identity's 'from' email address. Use this when the original verification email was not received, expired, or needs to be resent. The sender identity must hav
- sendgrid_resend_teammate_invite(token: string) — Resend a pending teammate invitation to refresh its expiration date. Teammate invitations expire after 7 days. Use this endpoint to resend an invitation that hasn't been accepted yet, which will reset
- sendgrid_resend_verified_sender_request(id: integer) — Resends the verification email to a Sender Identity's 'from_email' address. Use this when the original verification email was lost, expired, or needs to be resent. The sender must have been created vi
- sendgrid_retrieve_a_bounce(email: string, on-behalf-of?: string) — Retrieves details about a specific bounced email address from the SendGrid suppression list. Use this endpoint to look up bounce information for a particular email address, including: - When the bounc
- sendgrid_retrieve_a_branded_link(id: integer) — Retrieves a specific branded link by its ID. Branded links (formerly 'Link Whitelabel') allow click-tracked links, opens, and images in your emails to be served from your domain rather than sendgrid.n
- sendgrid_retrieve_a_count_of_recipients() — Retrieve the total count of recipients in the Legacy Marketing Campaigns contact database. **IMPORTANT: This is a Legacy API endpoint.** The contactdb API (`/v3/contactdb/*`) is part of the Legacy Mar
- sendgrid_retrieve_a_custom_field(custom_field_id: string) — Retrieves a single custom field definition by its ID from SendGrid Marketing Campaigns. Custom fields store additional information about your contacts beyond the reserved fields (email, first_name, la
- sendgrid_retrieve_a_global_suppression(email: string) — Checks if an email address is in the global suppression list. Globally suppressed emails will not receive any emails from your SendGrid account. Returns the email address if found in the global suppre
- sendgrid_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.
- sendgrid_retrieve_a_reverse_dns_record(id: string) — Retrieves a specific reverse DNS (formerly IP Whitelabel) record by its ID. Reverse DNS allows mailbox providers to verify the sender of an email by performing a reverse DNS lookup. This endpoint retu
- sendgrid_retrieve_a_single_campaign(campaign_id: integer) — Retrieves a specific campaign from SendGrid's Legacy Marketing Campaigns by its ID. Returns campaign details including title, subject, content, recipients, and status. Note: This is part of the Legacy
- sendgrid_retrieve_a_single_list(id: string, contact_sample?: boolean) — Retrieve detailed information about a specific marketing list by its unique ID. This endpoint returns the list's name, contact count, and metadata. When the optional `contact_sample` parameter is set 
- sendgrid_retrieve_a_single_recipient(recipient_id: string) — Retrieve a single recipient by ID from the Legacy Marketing Campaigns contact database. **IMPORTANT**: This is a Legacy Marketing Campaigns API endpoint (/v3/contactdb/). Newer SendGrid accounts may n
- sendgrid_retrieve_a_single_transactional_template(template_id: string) — Retrieves a single transactional template by its ID, including all associated template versions. Transactional templates are used for sending personalized emails with dynamic content replacement using
- sendgrid_retrieve_a_specific_alert(alert_id: integer) — Retrieve details for a specific SendGrid alert by its ID. Alerts notify you about email usage limits or provide periodic email statistics. Use this endpoint to get full details of a single alert inclu
- sendgrid_retrieve_a_specific_allowed_ip(rule_id: string) — Retrieves details of a specific IP address from your SendGrid account's IP Access Management allow list using its unique rule ID. Returns the IP address, creation timestamp, and last update timestamp.
- sendgrid_retrieve_a_specific_block(email: string, on-behalf-of?: string) — Retrieves details for a specific email address from your SendGrid blocks list. Blocks occur when a recipient's email server rejects the message for a reason related to the message itself, not the reci
- sendgrid_retrieve_a_specific_invalid_email(email: string) — Retrieves details about a specific email address from SendGrid's invalid email suppression list. Invalid emails are addresses that have bounced because of a permanent error such as an invalid mailbox 
- sendgrid_retrieve_a_specific_parse_setting(hostname: string) — Retrieves a specific inbound parse webhook setting by hostname. This endpoint returns the configuration details for an inbound parse setting, which defines how SendGrid handles incoming emails for a p
- sendgrid_retrieve_a_specific_spam_report(email: string) — Retrieves a specific spam report by email address from SendGrid's suppression list. Spam reports are generated when a recipient marks an email as spam. This action allows you to check if a specific em
- sendgrid_retrieve_a_specific_transactional_template_version(version_id: string, template_id: string) — Retrieves a specific version of a transactional template by its template ID and version ID. Transactional templates in SendGrid can have multiple versions, allowing for A/B testing, localization, or i
- sendgrid_retrieve_a_subuser_s_branded_link(username: string) — Retrieve the branded link associated with a specific subuser. Email link branding (formerly 'Link Whitelabel') allows click-tracked links, opens, and images in emails to be served from your domain rat
- sendgrid_retrieve_access_requests(limit?: integer, offset?: integer) — Retrieve a list of recent access requests using pagination with `limit` for page size and `offset` to control the start position for additional items.
- sendgrid_retrieve_address_whitelist_mail_settings() — Retrieves your current address whitelist mail settings from SendGrid. The Address Whitelist setting allows you to specify email addresses or domains for which mail should never be suppressed. For exam
- sendgrid_retrieve_all_alerts() — Retrieve all SendGrid alerts configured for your account. Returns a list of alert configurations including: - **usage_limit alerts**: Notify when email usage reaches a specified percentage threshold (
- sendgrid_retrieve_all_assigned_ips() — Retrieves all IP addresses that are currently assigned to your account. This endpoint returns a list of IP addresses that have been assigned to your account for sending emails. Each IP address include
- sendgrid_retrieve_all_blocks(email?: string, limit?: integer, offset?: integer, end_time?: integer, start_time?: integer, on-behalf-of?: string) — Retrieves a paginated list of all blocked email addresses from your SendGrid account. Blocks occur when a recipient's email server rejects a message for reasons related to the message itself (not the 
- sendgrid_retrieve_all_bounces(email?: string, limit?: integer, offset?: integer, end_time?: integer, start_time?: integer) — 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.
- sendgrid_retrieve_all_branded_links(limit?: integer) — **This endpoint allows you to retrieve all branded links**. You can submit this request as one of your subusers if you include their ID in the `on-behalf-of` header in the request.
- sendgrid_retrieve_all_campaigns(limit?: integer, offset?: integer) — Retrieve a paginated list of campaigns in reverse creation order with the API endpoint. If none exist, get an empty array. Adjust page size with `limit`, and fetch more with `offset`.
- sendgrid_retrieve_all_categories(limit?: integer, offset?: integer, category?: string) — Retrieve all email categories used for tracking and organizing email statistics. Categories are user-defined labels that can be assigned to emails when sending. They help organize email statistics and
- sendgrid_retrieve_all_custom_fields() — Retrieve all custom field definitions for contacts. Returns a list of all custom fields that have been created for your contacts. Custom fields allow you to store additional information about your con
- sendgrid_retrieve_all_global_suppressions(email?: string, limit?: integer, offset?: integer, end_time?: integer, start_time?: integer) — Retrieves a paginated list of all email addresses that are globally suppressed from receiving any emails from your SendGrid account. Global suppressions are recipients who have unsubscribed from all y
- sendgrid_retrieve_all_invalid_emails(email?: string, limit?: integer, offset?: integer, end_time?: integer, start_time?: integer) — Retrieve paginated lists of invalid emails with 'limit' for page size and 'offset' to start from a specific position for lists exceeding the limit.
- sendgrid_retrieve_all_ip_addresses(ip?: string, limit?: integer, offset?: integer, subuser?: string, sort_by_direction?: string, exclude_whitelabels?: boolean) — Retrieve a paginated list of assigned/unassigned IPs with warmup status, pools, subusers, and DNS info. IP reputation is based on email traffic. Use `limit` and `offset` parameters to control paginati
- sendgrid_retrieve_all_ip_pools() — **This endpoint allows you to get all of your IP pools.**
- sendgrid_retrieve_all_ip_pools_an_ip_address_belongs_to(ip_address: string) — 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. The same IP address can belong to multiple IP pools. 
- sendgrid_retrieve_all_ips_currently_in_warmup() — Retrieve all IP addresses currently in the warmup process. IP warmup is the process of gradually increasing sending volume through a new IP address to build a positive sending reputation. This endpoin
- sendgrid_retrieve_all_lists(page_size?: integer, page_token?: string) — Retrieve all contact lists from your SendGrid account. Lists are static collections of Marketing Campaigns contacts. Returns an array of all lists with their IDs, names, and contact counts. If no list
- sendgrid_retrieve_all_mail_settings(limit?: integer, offset?: integer) — Retrieve a paginated list of mail settings with their `enabled` status and descriptions. Control page size with `limit` and list position with `offset` for multiple requests.
- sendgrid_retrieve_all_of_your_event_webhooks(include?: string) — 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.
- sendgrid_retrieve_all_parse_settings() — **This endpoint allows you to retrieve all of your current inbound parse settings.**
- sendgrid_retrieve_all_pending_teammates() — **This endpoint allows you to retrieve a list of all pending Teammate invitations.** Each teammate invitation is valid for 7 days. Users may resend the invitation to refresh the expiration date.
- sendgrid_retrieve_all_recent_access_attempts(limit?: integer) — Retrieves a list of all IP addresses that have recently attempted to access your SendGrid account, either through the User Interface or the API. This endpoint is part of SendGrid's IP Access Managemen
- sendgrid_retrieve_all_recipients_on_a_list(page?: integer, list_id: integer, page_size?: integer) — Retrieves all recipients (contacts) belonging to a specific list in SendGrid's Legacy Marketing Campaigns. **IMPORTANT**: This endpoint is part of SendGrid's legacy Contacts API (`/v3/contactdb/`). So
- sendgrid_retrieve_all_reverse_dns_records(ip?: string, limit?: integer, offset?: integer) — The endpoint provides a paginated list of Reverse DNS records, with optional IP prefix search and adjustable page size using 'limit' and 'offset' parameters.
- sendgrid_retrieve_all_scheduled_sends() — The endpoint provides details of cancelled or paused scheduled sends but only if they have a `batch_id`. Sends scheduled without a `batch_id` via `/mail/send` won't be listed and can't be paused or ca
- sendgrid_retrieve_all_spam_reports(email?: string, limit?: integer, offset?: integer, end_time?: integer, start_time?: integer) — Retrieve spam reports in pages using `limit` for page size and `offset` to continue from a specific list position. Multiple requests handle larger lists.
- sendgrid_retrieve_all_suppressions(on-behalf-of?: string) — Retrieve a list of all suppressions across all suppression groups. Suppressions are recipient email addresses that have been added to unsubscribe groups. Once a recipient's address is on the suppressi
- sendgrid_retrieve_all_suppressions_for_a_suppression_group(group_id: string) — **This endpoint allows you to retrieve all suppressed email addresses belonging to the given group.**
- sendgrid_retrieve_all_teammates(limit?: integer, offset?: integer) — Retrieve a paginated list of Teammates with the `limit` parameter to set page size and `offset` to specify the starting point for additional items. Make multiple requests if needed.
- sendgrid_retrieve_all_the_ips_in_a_specified_pool(pool_name: string) — Retrieves all IP addresses that are assigned to a specific IP pool. IP pools allow you to group your dedicated SendGrid IP addresses together (e.g., separate pools for transactional and marketing emai
- sendgrid_retrieve_an_authenticated_domain(domain_id: string) — Retrieves details of a specific authenticated domain by its unique ID. An authenticated domain (formerly called "Domain Whitelabel") allows you to remove the "via" or "sent on behalf of" message that 
- sendgrid_retrieve_an_existing_api_key(api_key_id: string) — Retrieves the details of an existing SendGrid API key by its unique identifier. Returns the API key's name and permission scopes. Note: The actual API key string cannot be retrieved after creation for
- sendgrid_retrieve_bounce_classification_totals(end_date?: string, start_date?: string) — This endpoint will return the total number of bounces by classification in descending order for each day. You can retrieve the bounce classification totals in CSV format by specifying `"text/csv"` in 
- sendgrid_retrieve_bounce_purge_mail_settings(on_behalf_of?: string) — Retrieve your current Bounce Purge mail settings. This setting configures the maximum age (in days) of contacts in your hard and soft bounce suppression lists before they are automatically purged. Not
- sendgrid_retrieve_click_track_settings() — Retrieves your current click tracking settings from SendGrid. Click tracking monitors user engagement by redirecting links in your emails through SendGrid's servers, allowing you to track when recipie
- sendgrid_retrieve_current_enforced_tls_settings() — Retrieve the current Enforced TLS settings for your SendGrid account. Enforced TLS settings control whether recipients must support TLS encryption and have valid certificates to receive your emails. B
- sendgrid_retrieve_email_statistics_by_browser(limit?: integer, offset?: integer, browsers?: string, end_date?: string, start_date: string, aggregated_by?: string) — Retrieve email statistics segmented by browser type (Chrome, Firefox, Safari, etc.). This endpoint is part of the Advanced Stats API and requires the 'browsers.stats.read' permission. Note: SendGrid o
- sendgrid_retrieve_email_statistics_by_client_type(limit?: integer, offset?: integer, end_date?: string, start_date: string, aggregated_by?: string) — Retrieve email statistics segmented by client type (Webmail, Desktop, Phone, Tablet, Other). This endpoint is part of the Advanced Stats API and requires the 'clients.stats.read' permission. Note: Sen
- sendgrid_retrieve_email_statistics_by_device_type(limit?: integer, offset?: integer, end_date?: string, start_date: string, aggregated_by?: string) — Retrieve email statistics segmented by device type (Desktop, Webmail, Phone, Tablet, Other). This endpoint is part of the Advanced Stats API and requires the 'stats.read' permission. Note: SendGrid on
- sendgrid_retrieve_email_statistics_by_mailbox_provider(limit?: integer, offset?: integer, end_date?: string, start_date: string, aggregated_by?: string, mailbox_providers?: string) — Retrieve email statistics segmented by recipient mailbox provider (e.g., Gmail, Yahoo, Microsoft Outlook). This endpoint is part of the Advanced Stats API and requires the 'stats.read' permission. Not
- sendgrid_retrieve_email_statistics_for_categories(limit?: integer, offset?: integer, end_date?: string, categories: string, start_date: string, aggregated_by?: string) — Retrieve email statistics for specific categories within a date range. This endpoint returns detailed email metrics (delivered, opens, clicks, bounces, spam reports, etc.) for the specified categories
- sendgrid_retrieve_email_statistics_for_your_subusers(limit?: integer, offset?: integer, end_date?: string, subusers: string, start_date: string, aggregated_by?: string) — Retrieves email statistics for specified subusers over a date range. Returns metrics including: blocks, bounces, clicks, delivered, opens, requests, unique_clicks, unique_opens, unsubscribes, and more
- sendgrid_retrieve_footer_mail_settings(on_behalf_of?: string) — Retrieve your current Footer mail settings from SendGrid. The Footer setting allows you to insert a custom footer at the bottom of all text and HTML email message bodies sent via the SendGrid v3 API o
- sendgrid_retrieve_forward_bounce_mail_settings() — Retrieves the current forward bounce mail settings for your SendGrid account. Forward bounce mail settings allow you to specify an email address to which bounce reports will be forwarded. When enabled
- sendgrid_retrieve_forward_spam_mail_settings(on_behalf_of?: string) — Retrieves the current forward spam mail settings for your SendGrid account. Forward spam mail settings allow you to specify email address(es) to which spam reports will be forwarded. When enabled, you
- sendgrid_retrieve_global_email_statistics(limit?: integer, offset?: integer, end_date?: string, start_date: string, aggregated_by?: string) — Retrieve global email statistics for your SendGrid account within a specific date range. Returns aggregated email metrics including: requests, delivered, bounces, blocks, opens, unique_opens, clicks, 
- sendgrid_retrieve_google_analytics_settings() — Retrieves the current Google Analytics tracking settings for your SendGrid account. Google Analytics tracking adds UTM parameters to links in your emails to help you track user behavior and campaign p
- sendgrid_retrieve_legacy_template_mail_settings() — Retrieves your current legacy email template mail settings. The legacy template setting wraps an HTML template around your email content, useful for marketing emails and HTML-formatted messages. Note:
- sendgrid_retrieve_monthly_stats_for_all_subusers(date: string, limit?: integer, offset?: integer, subuser?: string, sort_by_metric?: string, sort_by_direction?: string) — Retrieves monthly email statistics for all subusers. Returns metrics such as blocks, bounces, clicks, delivered emails, opens, requests, unique clicks/opens, and unsubscribes. **Note**: This endpoint 
- sendgrid_retrieve_paged_transactional_templates(page_size: integer, page_token?: string, generations?: string) — **This endpoint allows you to retrieve all transactional templates.**
- sendgrid_retrieve_recipients(page?: integer, page_size?: integer) — Retrieve all marketing campaign recipients via this endpoint. Use batch deletion carefully, as it may lead to empty pages. Continue iterating pages until a 404 error occurs to ensure complete retrieva
- sendgrid_retrieve_recipients_on_a_segment(page?: integer, page_size?: integer, segment_id: integer) — Retrieves all recipients (contacts) in a specified segment from SendGrid's Legacy Marketing Campaigns Contact Database. This endpoint returns recipient data including: - Contact info: id, email, first
- sendgrid_retrieve_reserved_fields() — **Retrieve all reserved fields from the Legacy Marketing Campaigns Contact Database.** This endpoint returns a list of fields that are reserved by SendGrid and cannot be used as custom field names. Re
- sendgrid_retrieve_scheduled_send(batch_id: string) — Retrieve the cancel/pause status of a scheduled email batch by its batch_id. Use this action to check whether a batch of scheduled emails has been paused or cancelled. The batch_id must have been crea
- sendgrid_retrieve_single_segment_endpoint(query_json?: boolean, segment_id: string) — Retrieves detailed information about a specific Marketing Campaigns segment by its unique ID. Returns segment metadata including the SQL query defining membership criteria (query_dsl), contact count, 
- sendgrid_retrieve_specific_teammate(username: string) — Retrieves details of a specific SendGrid teammate by username. Returns teammate information including email, name, user type, admin status, and permission scopes. Use 'Retrieve all teammates' first to
- sendgrid_retrieve_stats_by_a_specific_client_type(end_date?: string, start_date: string, client_type: string, aggregated_by?: string) — Retrieve email statistics for a specific client type (phone, tablet, webmail, or desktop). This endpoint is part of the Advanced Stats API and provides email engagement metrics (opens, unique_opens) f
- sendgrid_retrieve_subscription_tracking_settings() — Retrieves the current subscription tracking settings for your SendGrid account. Subscription tracking automatically adds unsubscribe/subscribe links to the bottom of your emails, allowing recipients t
- sendgrid_retrieve_subuser_reputations(usernames?: string) — Retrieves sender reputation scores (0-100) for subusers. Reputation reflects email delivery performance based on recipient engagement, bounces, spam reports, and other negative actions. Higher scores 
- sendgrid_retrieve_sums_of_email_stats_for_each_category(limit?: integer, offset?: integer, end_date?: string, start_date: string, aggregated_by?: string, sort_by_metric?: string, sort_by_direction?: string) — Retrieve aggregated email statistics sums for each category over a date range. This action returns the total sum of each email statistic metric (delivered, opens, clicks, bounces, etc.) for every cate
- sendgrid_retrieve_the_count_of_billable_recipients() — Retrieves the count of billable recipients for SendGrid Legacy Marketing Campaigns. This endpoint returns the number of Marketing Campaigns recipients you will be billed for. You are billed for market
- sendgrid_retrieve_the_default_branded_link(domain?: string) — Retrieves the default branded link for message sending. Branded links (formerly 'Link Whitelabel') allow click-tracked links, opens, and images in your emails to be served from your domain rather than
- sendgrid_retrieve_the_lists_that_a_recipient_is_on(recipient_id: string) — Retrieves all marketing campaign lists that a specific recipient belongs to. NOTE: This is a Legacy Marketing Campaigns API endpoint (/v3/contactdb/). For new implementations, consider using the new M
- sendgrid_retrieve_tracking_settings() — **This endpoint allows you to retrieve a list of all tracking settings on your account.**
- sendgrid_retrieve_user_s_authenticated_domains(username: string) — Retrieve authenticated domains (up to five) assigned to a specific subuser. Parent accounts use this to view domains their subusers can use for sending emails. Requires 'Subuser Management' and 'Domai
- sendgrid_retrieve_your_account_email_address() — Retrieves the email address currently on file for your SendGrid account. This endpoint returns the primary email address associated with your account, which is used for account-related communications 
- sendgrid_retrieve_your_credit_balance() — Retrieves the current email credit balance for your SendGrid account. This endpoint returns information about your account's email sending credits, including the total number of credits, remaining cre
- sendgrid_retrieve_your_username() — Retrieve your current SendGrid account username and user ID. This endpoint returns your account username and user ID. **Required Scope**: user.username.read **Returns**: - username (str): Your SendGri
- sendgrid_retrieves_inbound_parse_webhook_statistics(limit?: integer, offset?: integer, end_date?: string, start_date: string, aggregated_by?: string) — Retrieve statistics for emails processed by SendGrid's Inbound Parse Webhook. This endpoint returns metrics about the number of emails received and processed by the Inbound Parse Webhook within a spec
- sendgrid_returns_a_list_of_all_partner_settings(limit?: integer, offset?: integer) — Retrieve a paginated list of all partner settings that can be enabled for your SendGrid account. Partner settings allow integration with third-party services. Note: As of August 30, 2022, Twilio SendG
- sendgrid_schedule_a_campaign(send_at: integer, campaign_id: integer) — Schedules a Legacy Marketing Campaigns email for delivery at a specific time. The campaign must have subject, sender_id, content (HTML and plain text with [unsubscribe] tag), and at least one list or 
- sendgrid_schedule_single_send(id: string, send_at: string) — Schedule a Single Send for immediate or future delivery. Use `send_at: 'now'` to send immediately, or provide an ISO 8601 date-time for scheduled delivery. The Single Send must be fully configured wit
- sendgrid_search_contacts(query: string) — Find contacts using this endpoint with a body containing a `query` in SGQL. Searches must use lowercase, and only the first 50 matches are returned. Queries over 20s will timeout. Dates are in ISO for
- sendgrid_search_for_suppressions_within_a_group(group_id: string, recipient_emails: string[]) — **This endpoint allows you to search a suppression group for multiple suppressions.** When given a list of email addresses and a group ID, this endpoint will only return the email addresses that have 
- sendgrid_search_recipients(field_name: string, field_value: string) — Search for recipients in the Legacy Marketing Campaigns contact database by field value. This endpoint allows searching recipients by any field (email, first_name, last_name, or custom fields). It per
- sendgrid_send_a_campaign(campaign_id: integer) — Immediately sends an existing marketing campaign to its configured recipients. **IMPORTANT**: This is a Legacy Marketing Campaigns API endpoint. You may only send a campaign when it is in 'draft' stat
- sendgrid_send_a_test_campaign(to: string|string[], campaign_id: integer) — Sends a test version of a marketing campaign to specified email addresses for review before sending to your full recipient list. **IMPORTANT:** This is part of the Legacy Marketing Campaigns API which
- sendgrid_send_a_test_marketing_email(emails: string[], sender_id?: integer, template_id: string, from_address?: string, version_id_override?: string, suppression_group_id?: integer, custom_unsubscribe_url?: string) — Send a test marketing email before launching a campaign. This endpoint allows you to test your marketing email by sending it to up to 10 email addresses. The test email uses a Dynamic Transactional Te
- sendgrid_send_email_with_twilio_send_grid(content?: object[], send_at?: integer, subject?: string, batch_id?: string, categories?: string[], from__name?: string, attachments?: object[], custom_args?: string, from__email?: string, template_id?: string, ip_pool_name?: string, reply_to_list?: object[], asm__group__id?: integer, reply__to__name?: string, personalizations: object[], reply__to__email?: string, asm__groups__to__display?: integer[], mail__settings__footer__html?: string, mail__settings__footer__text?: string, mail__settings__footer__enable?: boolean, mail__settings__sandbox__mode__enable?: boolean, tracking__settings__ganalytics__enable?: boolean, tracking__settings__ganalytics__utm__term?: string, tracking__settings__open__tracking__enable?: boolean, tracking__settings__click__tracking__enable?: boolean, tracking__settings__ganalytics__utm__medium?: string, tracking__settings__ganalytics__utm__source?: string, tracking__settings__ganalytics__utm__content?: string, tracking__settings__ganalytics__utm__campaign?: string, mail__settings__bypass__list__management__enable?: boolean, mail__settings__bypass__spam__management__enable?: boolean, tracking__settings__subscription__tracking__html?: string, tracking__settings__subscription__tracking__text?: string, tracking__settings__click__tracking__enable__text?: boolean, mail__settings__bypass__bounce__management__enable?: boolean, tracking__settings__subscription__tracking__enable?: boolean, tracking__settings__open__tracking__substitution__tag?: string, mail__settings__bypass__unsubscribe__management__enable?: boolean, tracking__settings__subscription__tracking__substitution__tag?: string) — The Mail Send operation uses SendGrid's v3 API to send emails. Visit the provided link for an overview, features, limitations, quickstarts, and helper libraries.
- sendgrid_set_up_reverse_dns(ip: string, domain: string, subdomain?: string) — Set up reverse DNS (rDNS) for a dedicated IP address. Reverse DNS allows mailbox providers to verify the sender by performing a reverse DNS lookup when receiving emails. This improves email deliverabi
- sendgrid_start_warming_up_an_ip_address(ip: string) — Put a dedicated IP address into warmup mode. IP warmup gradually increases the sending volume from an IP address to build a positive sending reputation. SendGrid automatically limits the hourly email 
- sendgrid_stop_warming_up_an_ip_address(ip_address: string) — Stop warming up a dedicated IP address and remove automatic sending limits. When an IP is in warmup mode, SendGrid automatically limits the hourly email volume to gradually build sender reputation. Th
- sendgrid_sum_email_stats_for_subusers(limit?: integer, offset?: integer, end_date?: string, start_date: string, aggregated_by?: string, sort_by_metric?: string, sort_by_direction?: string) — Retrieves summed email statistics for all subusers over a date range. Returns aggregated metrics including: blocks, bounces, clicks, delivered, opens, requests, unique_clicks, unique_opens, unsubscrib
- sendgrid_test_an_event_webhook_s_settings(id?: string, url: string, oauth_client_id?: string, oauth_token_url?: string, oauth_client_secret?: string) — Sends a test event notification to a specified URL to verify your webhook endpoint is properly configured to receive SendGrid events. The test sends a POST request with a JSON array containing sample 
- sendgrid_toggle_webhook_signature(id: string, enabled: boolean) — Enable or disable signature verification for a single Event Webhook by its ID. When signature verification is enabled, SendGrid generates an ECDSA key pair and signs all webhook payloads using the pri
- sendgrid_unlink_subuser_domain(username: string, domain_id: integer) — Disassociate an authenticated domain from a subuser. This removes the link between a domain authentication and a specific subuser, preventing the subuser from sending emails using that domain. Prerequ
- sendgrid_unschedule_a_scheduled_campaign(campaign_id: integer) — Unschedule a campaign that has already been scheduled to be sent. **Note**: This endpoint is part of the Legacy Marketing Campaigns API. SendGrid recommends migrating to the new Marketing Campaigns fo
- sendgrid_update_a_branded_link(id: integer, default?: boolean) — Update a specific branded link's default status. Link branding (formerly 'Link Whitelabel') allows all click-tracked links in your emails to be served from your domain rather than sendgrid.net. Use th
- sendgrid_update_a_campaign(title?: string, subject?: string, categories?: string[], campaign_id: integer, html_content?: string, plain_content?: string) — Updates an existing marketing campaign. You can modify the campaign's title, subject line, HTML content, plain text content, and categories. Note: You can only update campaigns that are in draft statu
- sendgrid_update_a_list(name: string, list_id: integer) — Updates the name of an existing recipient list in the Marketing Campaigns. This action allows you to rename a contact list. Lists are static collections of contacts in SendGrid Marketing Campaigns tha
- sendgrid_update_a_parse_setting(url?: string, hostname: string, send_raw?: boolean, spam_check?: boolean, on_behalf_of?: string) — Updates an existing Inbound Parse Webhook setting by hostname. **Prerequisites:** 1. The hostname must already exist as a configured parse setting. 2. Use 'Retrieve all parse settings' to list availab
- sendgrid_update_a_scheduled_campaign(send_at: integer, campaign_id: integer) — Updates the scheduled send time for a Legacy Marketing Campaigns email. The campaign must already be scheduled before using this endpoint. Use the Schedule a Campaign endpoint first to initially sched
- sendgrid_update_a_scheduled_send(status: string, batch_id: string) — Update the status of a scheduled send batch that already has a pause or cancel status. Use to change between 'pause' and 'cancel' on batches that have an existing status (set via 'cancel_or_pause_a_sc
- sendgrid_update_a_segment(name?: string, query_dsl?: string, segment_id: string) — Updates an existing segment in SendGrid's Marketing Campaigns using the Segmentation V2 API. You can update the segment's name and/or the SQL query that defines membership criteria. At least one of 'n
- sendgrid_update_a_sender(id: integer, zip?: string, city?: string, state?: string, address?: string, country?: string, nickname?: string, address_2?: string, from__name?: string, from__email?: string, reply__to__name?: string, reply__to__email?: string) — Updates an existing Sender identity for use in SendGrid Marketing Campaigns. **Important Notes:** - Partial updates are supported - only include fields you want to change. - Changes to `from_email` re
- sendgrid_update_a_sender_identity(zip?: string, city?: string, state?: string, address?: string, country?: string, nickname?: string, address_2?: string, sender_id: integer, from__name?: string, from__email?: string, reply__to__name?: string, reply__to__email?: string) — Updates an existing sender identity in SendGrid. This action allows partial updates - only the fields you provide will be modified, while all other fields remain unchanged. **Important Notes:** - Chan
- sendgrid_update_a_single_event_webhook_by_id(id: string, url?: string, open?: boolean, click?: boolean, bounce?: boolean, dropped?: boolean, enabled?: boolean, include?: string, deferred?: boolean, delivered?: boolean, processed?: boolean, spam_report?: boolean, unsubscribe?: boolean, friendly_name?: string, oauth_client_id?: string, oauth_token_url?: string, group_resubscribe?: boolean, group_unsubscribe?: boolean, oauth_client_secret?: string) — Updates the configuration of a specific Event Webhook by its ID. You can modify the webhook URL, enable/disable it, subscribe to specific event types (bounce, click, delivered, open, etc.), set a frie
- sendgrid_update_a_suppression_group(name?: string, group_id: string, is_default?: boolean, description?: string) — Updates an existing suppression group (also known as an unsubscribe group). A suppression group allows recipients to unsubscribe from specific types of emails (e.g., newsletters, promotions, alerts) r
- sendgrid_update_a_user_s_profile(zip?: string, city?: string, phone?: string, state?: string, address?: string, company?: string, country?: string, website?: string, address2?: string, last_name?: string, first_name?: string) — Updates the authenticated user's profile information in SendGrid. **Important:** At least one parameter must be provided. You can update any combination of profile fields including name, company, addr
- sendgrid_update_account_offerings(accountID: string, offerings: object[]) — Updates the offerings (email packages and add-ons) assigned to a customer account. IMPORTANT: This endpoint is part of the Account Provisioning API and is only available to Twilio SendGrid reseller pa
- sendgrid_update_address_whitelist_mail_settings(list?: string[], enabled?: boolean) — Updates the address whitelist mail settings for your SendGrid account. The Address Whitelist setting allows you to specify email addresses or domains for which mail should never be suppressed due to b
- sendgrid_update_an_account_s_state(state: string, accountID: string) — Update the state of a customer account using the Account Provisioning API. IMPORTANT: This endpoint is ONLY available to Twilio SendGrid reseller partners with a formal partnership agreement and prope
- sendgrid_update_an_alert(alert_id: integer, email_to?: string, frequency?: string, percentage?: integer) — Update an existing SendGrid alert's settings. Supports updating two types of alerts: - **usage_limit**: Update the percentage threshold (0-100) or email recipient. - **stats_notification**: Update the
- sendgrid_update_an_authenticated_domain(default?: boolean, domain_id: string, custom_spf?: boolean) — Updates the settings for an authenticated domain in SendGrid. Use this endpoint to modify the `custom_spf` and `default` settings for an existing authenticated domain. To get the domain_id, first use 
- sendgrid_update_an_ip_pool_name(name: string, poolid: string) — Updates the name of an existing IP Pool in your SendGrid account. IP Pools allow you to group your dedicated SendGrid IP addresses together for better management of email sending reputation. For examp
- sendgrid_update_an_sso_integration(id: string, si?: boolean, name?: string, enabled?: boolean, entity_id?: string, signin_url?: string, signout_url?: string, completed_integration?: boolean) — Update an existing Single Sign-On (SSO) integration for your SendGrid account. This endpoint allows you to modify SAML 2.0 SSO configuration settings for an integration with your Identity Provider (Id
- sendgrid_update_api_key_name(name: string, api_key_id: string) — Updates the name of an existing SendGrid API key. This endpoint only modifies the key's display name and does not change its permissions/scopes. Use this to rename API keys for better organization. To
- sendgrid_update_api_key_name_and_scopes(name: string, scopes: string[], api_key_id: string) — Updates both the name and permission scopes of an existing SendGrid API key. IMPORTANT: The scopes array completely replaces the key's existing permissions. To preserve existing permissions while addi
- sendgrid_update_bounce_purge_mail_settings(enabled?: boolean, hard_bounces?: integer, on_behalf_of?: string, soft_bounces?: integer) — Update your Bounce Purge mail settings in SendGrid. This setting configures automatic purging of contacts from your hard and soft bounce suppression lists based on a specified number of days (1-3650).
- sendgrid_update_click_tracking_settings(enabled?: boolean, enable_text?: boolean) — Updates click tracking settings for your SendGrid account. Click tracking monitors email engagement by redirecting links through SendGrid's servers (or your branded domain), allowing you to track when
- sendgrid_update_custom_field_definition(name: string, custom_field_id: string) — Updates the name of an existing custom field in SendGrid Marketing Contacts. Only custom fields can be modified; Reserved Fields (like email, first_name, last_name) cannot be updated. The field_type c
- sendgrid_update_design(id: string, name?: string, subject?: string, categories?: string[], html_content?: string, plain_content?: string, generate_plain_content?: boolean) — Updates an existing email design in the SendGrid Design Library using PATCH. Only fields provided in the request will be updated; other fields remain unchanged. Use this to modify design name, HTML co
- sendgrid_update_details_for_an_ip_address(ip: string, is_enabled?: boolean, is_auto_warmup?: boolean, is_parent_assigned?: boolean) — Updates settings for a dedicated IP address in your SendGrid account. This endpoint allows you to modify: - Auto warmup status: Enable/disable automatic IP warmup to build sender reputation - Parent a
- sendgrid_update_enforced_tls_settings(version?: number, require_tls?: boolean, require_valid_cert?: boolean) — Update the Enforced TLS settings for your SendGrid account. Enforced TLS controls whether recipients must support TLS encryption and have valid certificates to receive your emails. By default, SendGri
- sendgrid_update_footer_mail_settings(enabled?: boolean, html_content?: string, on_behalf_of?: string, plain_content?: string) — Update your Footer mail settings in SendGrid. This endpoint allows you to configure a custom footer that will be appended to the bottom of all outgoing text and HTML email bodies sent via the SendGrid
- sendgrid_update_forward_bounce_mail_settings(email?: string, enabled?: boolean) — Updates the forward bounce mail settings for your SendGrid account. Forward bounce mail settings allow you to specify an email address to which bounce reports (permanent delivery failures) will be for
- sendgrid_update_forward_spam_mail_settings(email?: string, enabled?: boolean) — Updates the Forward Spam mail settings for your SendGrid account. When enabled, spam reports will be forwarded to the specified email address(es). You can configure multiple forwarding addresses by pr
- sendgrid_update_google_analytics_settings(enabled?: boolean, utm_term?: string, utm_medium?: string, utm_source?: string, utm_content?: string, utm_campaign?: string) — Updates Google Analytics tracking settings for your SendGrid account. When enabled, UTM parameters are automatically appended to all links in your emails, allowing you to track email campaign performa
- sendgrid_update_integration(id: string, label?: string, destination?: string, filters__email__events?: string[], properties__write__key?: string, properties__destination__region?: string) — Update an existing Marketing Integration by its unique ID. An Integration is a connection from SendGrid Marketing Campaigns to a supported third-party application (currently only Segment is supported)
- sendgrid_update_list(id: string, name?: string) — Update the name of an existing contact list in SendGrid Marketing Campaigns. This endpoint allows you to rename a contact list. The list must already exist and you need its UUID to perform the update.
- sendgrid_update_open_tracking_settings(enabled?: boolean) — Updates open tracking settings for your SendGrid account. Open tracking monitors email engagement by inserting an invisible 1x1 pixel image (tracking pixel) at the end of HTML emails. When a recipient
- sendgrid_update_single_send(id: string, name?: string, send_at?: string, categories?: string[], send__to__all?: boolean, send__to__list__ids?: string[], email__config__editor?: string, email__config__subject?: string, send__to__segment__ids?: string[], email__config__ip__pool?: string, email__config__design__id?: string, email__config__sender__id?: integer, email__config__html__content?: string, email__config__plain__content?: string, email__config__suppression__group__id?: integer, email__config__custom__unsubscribe__url?: string, email__config__generate__plain__content?: boolean) — Update a Single Send draft by its ID. This endpoint allows you to modify specific properties of a Single Send without affecting other fields. Note: Setting 'send_at' prepopulates the send date in the 
- sendgrid_update_sso_certificate(cert_id: string, enabled?: boolean, integration_id?: string, public_certificate?: string) — Update an existing SSO (Single Sign-On) certificate by its ID. This endpoint allows you to modify the properties of an SSO certificate used for SAML 2.0 authentication. You can update the public certi
- sendgrid_update_subscription_tracking_settings(url?: string, enabled?: boolean, landing?: string, replace?: string, html_content?: string, plain_content?: string) — Updates subscription tracking settings for your SendGrid account. Subscription tracking automatically adds unsubscribe links to the bottom of your emails, allowing recipients to opt out of future comm
- sendgrid_update_teammate_s_permissions(scopes: string[], is_admin: boolean, username: string) — Updates a teammate's permissions in your SendGrid account. To grant full admin access: set `is_admin` to True and `scopes` to an empty array []. To assign specific permissions: set `is_admin` to False
- sendgrid_update_template_mail_settings(enabled?: boolean, html_content?: string) — Updates the legacy email template mail settings for your SendGrid account. When enabled, this template wraps around all emails sent via the SendGrid API. Note: SendGrid now recommends using Dynamic Tr
- sendgrid_update_the_credits_for_a_subuser(type: string, total?: integer, subuser_name: string, reset_frequency?: string) — Update the credit allocation settings for a SendGrid Subuser. This action allows you to configure how many email credits a Subuser can use and how those credits are managed. Credits control the number
- sendgrid_update_the_remaining_credits_for_a_subuser(subuser_name: string, allocation_update: integer) — Updates the remaining credits for a specific Subuser account by adding or subtracting from the current credit balance. Use a positive `allocation_update` value to increase credits or a negative value 
- sendgrid_update_your_account_email_address(email: string) — Updates the email address currently on file for your SendGrid account. This endpoint modifies the primary email address associated with your account, which is used for account-related communications f
- sendgrid_update_your_password(new_password: string, old_password: string) — Update the password for your SendGrid account. **Important**: This endpoint requires username/password authentication and cannot be accessed using API key authentication. API keys do not have the `use
- sendgrid_update_your_username(username: string) — Update the username for your SendGrid account. This endpoint allows you to change the username associated with your account. The username must be unique across all SendGrid accounts. **Required scope:
- sendgrid_validate_a_batch_id(batch_id: string) — Validate whether a mail batch ID exists in SendGrid's system. This endpoint checks if a batch ID has been created and is valid. A successful response (HTTP 200) indicates the batch ID exists. An inval
- sendgrid_validate_a_branded_link(id: integer, on-behalf-of?: string) — **This endpoint allows you to validate a branded link.** It checks that the required DNS CNAME records are correctly configured for your branded link domain. The validation verifies: - **domain_cname*
- sendgrid_validate_a_domain_authentication(id: integer, on-behalf-of?: string) — **This endpoint allows you to validate an authenticated domain.** It checks that the required DNS records are correctly configured for your sending domain. The validation verifies different records ba
- sendgrid_validate_a_reverse_dns_record(id: string) — Validate a reverse DNS (rDNS) record to check if DNS is properly configured. This endpoint verifies that the A record for reverse DNS has been correctly added to your DNS provider. After setting up re
- sendgrid_validate_an_email(email: string, source?: string) — Validates an email address and returns a verdict on its validity. This endpoint checks if an email address is valid, risky, or invalid by analyzing: - Email syntax and format - Domain DNS records (MX/
- sendgrid_verify_sender_request(token: string) — Verifies a sender identity using a token from the verification email. When you create a sender identity via 'Create Verified Sender Request', SendGrid sends a verification email to that address. The e
- sendgrid_view_a_sender_identity(sender_id: integer) — Retrieves the details of a specific Legacy Sender Identity by its unique ID. Returns comprehensive sender information including: - Sender identification (ID, nickname) - Email configuration (from emai
- sendgrid_view_scheduled_time_of_a_campaign(campaign_id: integer) — Retrieves the scheduled send date and time for a Legacy Marketing Campaign. Use this endpoint to check when a campaign is scheduled to be sent. Note: This endpoint is part of the Legacy Marketing Camp

## Example prompts
- "What can I do in SendGrid?"
- "Show me a summary of my SendGrid account"

## Links
Docs: https://mcp.ai/docs/mcps/sendgrid
Website: https://mcp.ai/mcps/sendgrid