Twilio SendGrid Mail Settings API
The Twilio SendGrid Mail Settings API allows you to retrieve and configure the various Mail Settings available. Mail Settings instruct SendGrid to apply…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
The Twilio SendGrid Mail Settings API allows you to retrieve and configure the various Mail Settings available. Mail Settings instruct SendGrid to apply specific settings to every email that you send over SendGrid’s Web API or SMTP relay. These settings include how to embed a custom footer, how to manage blocks, spam, and bounces, and more.
For a full list of Twilio SendGrid's Mail Settings, and what each one does, see Mail Settings.
You can also manage your Mail Settings in the Twilio SendGrid application user interface.
Endpoints 13
Mail Settings
- GETRetrieve all mail settings
/v3/mail_settings?limit=0&offset=0This endpoint allows you to retrieve a paginated list of all mail settings. Each setting will be returned with an enabled status set to true or false and a… - GETRetrieve address whitelist mail settings
/v3/mail_settings/address_whitelistThis endpoint allows you to retrieve your current email address whitelist settings. The Address Whitelist setting allows you to specify email addresses or… - PATCHUpdate address whitelist mail settings
/v3/mail_settings/address_whitelistThis endpoint allows you to update your current email address whitelist settings. For Regional Subusers - Utilizing this feature for Regional (EU) subusers… - GETRetrieve Bounce Purge Mail Settings
/v3/mail_settings/bounce_purgeThis endpoint allows you to retrieve your current Bounce Purge mail settings. The Bounce Purge mail setting allows you to configure the maximum age of… - PATCHUpdate Bounce Purge Mail Settings
/v3/mail_settings/bounce_purgeThis endpoint allows you to update your current Bounce Purge mail settings. The Bounce Purge mail metting allows you to configure the maximum age of contacts… - GETRetrieve footer mail settings
/v3/mail_settings/footerThis endpoint allows you to retrieve your current Footer mail settings. The Footer setting will insert a custom footer at the bottom of your text and HTML… - PATCHUpdate footer mail settings
/v3/mail_settings/footerThis endpoint allows you to update your current Footer mail settings. The Footer setting will insert a custom footer at the bottom of your text and HTML email… - GETRetrieve forward bounce mail settings
/v3/mail_settings/forward_bounceThis endpoint allows you to retrieve your current bounce forwarding mail settings. Enabling the Forward Bounce setting allows you to specify email addresses… - PATCHUpdate forward bounce mail settings
/v3/mail_settings/forward_bounceThis endpoint allows you to update your current bounce forwarding mail settings. Enabling the Forward Bounce setting allows you to specify an email address to… - GETRetrieve forward spam mail settings
/v3/mail_settings/forward_spamThis endpoint allows you to retrieve your current Forward Spam mail settings. Enabling the Forward Spam setting allows you to specify email addresses to which… - PATCHUpdate forward spam mail settings
/v3/mail_settings/forward_spamThis endpoint allows you to update your current Forward Spam mail settings. Enabling the Forward Spam setting allows you to specify email addresses to which… - GETRetrieve legacy template mail settings
/v3/mail_settings/templateThis endpoint allows you to retrieve your current legacy email template settings. This setting refers to our original email templates. We currently support… - PATCHUpdate template mail settings
/v3/mail_settings/templateThis endpoint allows you to update your current legacy email template settings. This setting refers to our original email templates. We currently support more…
API details
- Base URL
https://api.sendgrid.comhttps://api.eu.sendgrid.com- Authentication
- A bearer token in the Authorization header
- Operations
- 13 operations on 7 pathsGET 7PATCH 6
- Main resources
- Mail Settings 13
- Response formats
application/json- Description format
- OpenAPI 3.1.0, API version
1.0.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
How to test the Twilio SendGrid Mail Settings API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the Twilio SendGrid Mail Settings API collection, without the publisher's secrets.
- Add your credentialsThis API uses A bearer token in the Authorization header. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Retrieve all mail settings” (GET /v3/mail_settings?limit=0&offset=0), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the Twilio SendGrid Mail Settings API?
The Twilio SendGrid Mail Settings API allows you to retrieve and configure the various Mail Settings available. Mail Settings instruct SendGrid to apply… It is listed under Communication and has 13 endpoints.
Who publishes the Twilio SendGrid Mail Settings API?
It is listed from SendGrid's public API description (an OpenAPI document), not published by SendGrid on Swastik Codes. Anyone who controls sendgrid.com can claim the profile by adding a DNS TXT record.
What is the base URL of the Twilio SendGrid Mail Settings API?
Its description lists 2 base URLs: https://api.sendgrid.com, https://api.eu.sendgrid.com. The first is the usual one; the others are typically sandbox or regional servers.
How do I authenticate with the Twilio SendGrid Mail Settings API?
With A bearer token in the Authorization header.
How many endpoints does the Twilio SendGrid Mail Settings API have?
13 operations on 7 paths (7 GET, 6 PATCH). The largest groups are Mail Settings.
Is forking the Twilio SendGrid Mail Settings API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.