SendGrid

SendGrid Mail Settings API

Twilio SendGrid Mail Settings API

Documentation GitHub OpenAPI

Operations 13

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v3/mail_settings List all mail settings and whether they're on · Retrieve all mail settings #

Ask an LLM

“Which mail settings are enabled on my SendGrid account?”

“Can I page through the full list of mail settings with their descriptions?”

Tell an agent

List all my mail settings with their enabled status.

Show {limit} mail settings starting at offset {offset}.

PATCH /v3/mail_settings/address_whitelist Update the address whitelist setting · Update address whitelist mail settings #

Ask an LLM

“How can I make sure mail to my own domain is never suppressed?”

“Can I turn the address whitelist on without changing its list of addresses?”

Tell an agent

Set my address whitelist to {list} and enable it: {enabled}.

Turn the address whitelist setting {enabled}.

GET /v3/mail_settings/address_whitelist View the address whitelist setting · Retrieve address whitelist mail settings #

Ask an LLM

“Which email addresses or domains are exempt from suppression right now?”

“Is my address whitelist turned on?”

Tell an agent

Show my current address whitelist mail setting.

Tell me which addresses and domains are never suppressed.

PATCH /v3/mail_settings/bounce_purge Change bounce purge ages · Update Bounce Purge Mail Settings #

Ask an LLM

“Can I automatically clear soft bounces after a set number of days?”

“What controls the maximum age of contacts on my hard bounce list?”

Tell an agent

Purge soft bounces after {soft_bounces} days and hard bounces after {hard_bounces} days.

Set bounce purge enabled to {enabled}.

GET /v3/mail_settings/bounce_purge View bounce purge settings · Retrieve Bounce Purge Mail Settings #

Ask an LLM

“How long are hard and soft bounces kept before they are purged?”

“Is automatic bounce purging enabled on my account?”

Tell an agent

Show my current bounce purge settings.

Tell me the purge ages for my hard and soft bounce lists.

PATCH /v3/mail_settings/footer Set the footer added to every email · Update footer mail settings #

Ask an LLM

“How do I add a custom footer to every email I send?”

“Can I give the footer separate HTML and plain-text versions?”

Tell an agent

Set my email footer HTML to {html_content} and plain text to {plain_content}.

Turn the footer mail setting {enabled}.

GET /v3/mail_settings/footer View the email footer setting · Retrieve footer mail settings #

Ask an LLM

“What custom footer is currently added to the bottom of my emails?”

“Is the footer mail setting switched on?”

Tell an agent

Show my current footer mail setting.

Get the HTML and plain-text footer my emails use.

PATCH /v3/mail_settings/forward_bounce Forward bounce reports to an address · Update forward bounce mail settings #

Ask an LLM

“Can I get bounce reports forwarded to my own inbox?”

“What happens to bounce forwarding if I leave the email blank?”

Tell an agent

Forward bounce reports to {email}.

Set bounce report forwarding enabled to {enabled}.

GET /v3/mail_settings/forward_bounce View bounce forwarding setting · Retrieve forward bounce mail settings #

Ask an LLM

“Where are my bounce reports being forwarded?”

“Is bounce forwarding enabled?”

Tell an agent

Show my forward bounce mail setting.

Tell me which address receives forwarded bounce reports.

PATCH /v3/mail_settings/forward_spam Forward spam reports to addresses · Update forward spam mail settings #

Ask an LLM

“Can I forward spam complaints to several email addresses?”

“How do I stop spam reports being forwarded?”

Tell an agent

Forward spam reports to {email}.

Set spam report forwarding enabled to {enabled}.

GET /v3/mail_settings/forward_spam View spam report forwarding setting · Retrieve forward spam mail settings #

Ask an LLM

“Which addresses receive forwarded spam reports?”

“Is spam report forwarding turned on?”

Tell an agent

Show my forward spam mail setting.

List the addresses my spam reports are forwarded to.

PATCH /v3/mail_settings/template Update the legacy email template setting · Update template mail settings #

Ask an LLM

“How do I change the HTML wrapper of my legacy email template?”

“Can I turn off the legacy template that wraps outgoing mail?”

Tell an agent

Set my legacy email template HTML to {html_content}.

Switch the legacy template mail setting to enabled {enabled}.

GET /v3/mail_settings/template View the legacy email template setting · Retrieve legacy template mail settings #

Ask an LLM

“Is the legacy email template wrapping my messages?”

“What HTML does my original-style legacy template use?”

Tell an agent

Show my legacy template mail setting.

Get the HTML of the legacy template that wraps my emails.

Documentation

https://www.twilio.com/docs/sendgrid/api-reference/account-provisioning

https://www.twilio.com/docs/sendgrid/api-reference/alerts

https://www.twilio.com/docs/sendgrid/api-reference/api-keys

https://www.twilio.com/docs/sendgrid/api-reference/domain-authentication

https://www.twilio.com/docs/sendgrid/api-reference/email-activity

https://www.twilio.com/docs/sendgrid/api-reference/email-address-validation

https://www.twilio.com/docs/sendgrid/api-reference/enforced-tls

https://www.twilio.com/docs/sendgrid/api-reference/sendgrid-integrations

https://www.twilio.com/docs/sendgrid/api-reference/ip-access-management

https://www.twilio.com/docs/sendgrid/api-reference/ip-address-management-api

https://www.twilio.com/docs/sendgrid/api-reference/ip-warmup

https://www.twilio.com/docs/sendgrid/api-reference/ip-address

https://www.twilio.com/docs/sendgrid/api-reference/link-branding

https://www.twilio.com/docs/sendgrid/api-reference/campaigns-api

https://www.twilio.com/docs/sendgrid/api-reference/contacts-api-custom-fields

https://www.twilio.com/docs/sendgrid/api-reference/sender-identities-api

https://www.twilio.com/docs/sendgrid/api-reference/mail-settings

https://www.twilio.com/docs/sendgrid/api-reference/mail-send

https://www.twilio.com/docs/sendgrid/api-reference/contacts

https://www.twilio.com/docs/sendgrid/api-reference/custom-fields

https://www.twilio.com/docs/sendgrid/api-reference/designs-api

https://www.twilio.com/docs/sendgrid/api-reference/lists

https://www.twilio.com/docs/sendgrid/api-reference/segmenting-contacts-v2

https://www.twilio.com/docs/sendgrid/api-reference/segmenting-contacts

https://www.twilio.com/docs/sendgrid/api-reference/senders

https://www.twilio.com/docs/sendgrid/api-reference/single-sends

https://www.twilio.com/docs/sendgrid/api-reference/marketing-campaign-stats

https://www.twilio.com/docs/sendgrid/api-reference/send-test-email

https://www.twilio.com/docs/sendgrid/api-reference/partner-settings

https://www.twilio.com/docs/sendgrid/api-reference/recipients-data-erasure

https://www.twilio.com/docs/sendgrid/api-reference/reverse-dns

https://www.twilio.com/docs/sendgrid/api-reference/cancel-scheduled-sends

https://www.twilio.com/docs/sendgrid/api-reference/api-key-permissions

https://www.twilio.com/docs/sendgrid/api-reference/sendgrid-engagement-quality-api

https://www.twilio.com/docs/sendgrid/api-reference/single-sign-on-settings

https://www.twilio.com/docs/sendgrid/api-reference/stats

https://www.twilio.com/docs/sendgrid/api-reference/subusers-api

https://www.twilio.com/docs/sendgrid/api-reference/suppressions-unsubscribe-groups

https://www.twilio.com/docs/sendgrid/api-reference/teammates

https://www.twilio.com/docs/sendgrid/api-reference/transactional-templates

https://www.twilio.com/docs/sendgrid/api-reference/settings-tracking

https://www.twilio.com/docs/sendgrid/api-reference/users-api

https://www.twilio.com/docs/sendgrid/api-reference/sender-verification

https://www.twilio.com/docs/sendgrid/api-reference/webhooks

Specifications

https://raw.githubusercontent.com/api-evangelist/sendgrid/refs/heads/main/openapi/sendgrid-mail-settings-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this

find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/sendgrid-mail-settings-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: Twilio SendGrid Mail Settings API
  summary: The Twilio SendGrid Mail Settings API allows you to retrieve and configure the various Mail Settings available.
  description: The Twilio SendGrid Mail Settings API allows you to retrieve and configure the various Mail Settings available.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio SendGrid Support
    url: https://support.sendgrid.com/hc/en-us
  license:
    name: MIT
    url: https://code.hq.twilio.com/twilio/sendgrid-oas/blob/main/LICENSE
  version: 1.0.0
  x-sendgrid:
    libraryPackage: mail_settings
servers:
- url: https://api.sendgrid.com
  description: for global users and subusers
- url: https://api.eu.sendgrid.com
  description: for EU regional subusers
security:
- BearerAuth: []
tags:


# --- truncated at 32 KB (36 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/sendgrid/refs/heads/main/openapi/sendgrid-mail-settings-api-openapi.yml