Sign Up

Log In


By sendgridOfficial
Updated 2 months ago
Popularity Score
Success Rate

SendGrid API Documentation

Welcome to SendGrid’s Web API v3! This API is RESTful, fully featured, and easy to integrate with.

View API Details

Supercharge your App

Discover and connect to thousands of APIs in the world's largest API Hub
GETRetrieve all blocks
GETRetrieve a specific block
DELETEDelete a specific block
GETRetrieve all bounces
GETRetrieve a bounce
DELETEDelete a bounce
Invalid Emails
GETRetrieve all invalid emails
GETRetrieve a specific invalid email
DELETEDelete a specific invalid email
Spam Reports
GETRetrieve all spam reports
DELETEDelete a specific spam report
GETRetrieve a specific spam report
Cancel Scheduled Sends
POSTCreate a batch ID
GETValidate Batch ID
POSTCancel or pause a scheduled send
GETRetrieve all scheduled sends
GETRetrieve scheduled send
PATCHUpdate user scheduled send information
DELETEDelete a cancellation or pause of a scheduled send
Unsubscribe Groups
GETRetrieve all suppression groups associated with the user.
GETGet information on a single suppression group.
PATCHUpdate a suppression group.
DELETEDelete a suppression group.
POSTCreate a new suppression group
Suppressions (Unsubscribe)
POSTAdd suppressions to a suppression group
GETRetrieve all suppressions for a suppression group
DELETEDelete a suppression from a suppression group
GETRetrieve all suppressions
GETRetrieve all suppression groups for an email address
POSTSearch for suppressions within a group
Settings - Tracking
GETRetrieve Tracking Settings
GETRetrieve Click Track Settings
PATCHUpdate Click Tracking Settings
GETRetrieve Google Analytics Settings
PATCHUpdate Google Analytics Settings
GETGet Open Tracking Settings
PATCHUpdate Open Tracking Settings
GETRetrieve Subscription Tracking Settings
PATCHUpdate Subscription Tracking Settings
Settings - Mail
GETRetrieve all mail settings
GETRetrieve all BCC mail settings
PATCHUpdate BCC mail settings
GETRetrieve address whitelist mail settings
PATCHUpdate address whitelist mail settings
GETRetrieve footer mail settings
PATCHUpdate footer mail settings
GETRetrieve forward spam mail settings
PATCHUpdate forward spam mail settings
GETRetrieve plain content mail settings
PATCHUpdate plain content mail settings
GETRetrieve spam check mail settings
PATCHUpdate spam check mail settings
GETRetrieve bounce purge mail settings
PATCHUpdate bounce purge mail settings
GETRetrieve forward bounce mail settings
PATCHUpdate forward bounce mail settings
Settings - Inbound Parse
POSTCreate a parse setting
GETRetrieve all parse settings
GETRetrieve a specific parse setting
PATCHUpdate a parse setting
DELETEDelete a parse setting
Account Stats
GETRetrieve global email statistics
GETRetrieve email statistics by country and state/province.
GETRetrieve email statistics by device type.
GETRetrieve email statistics by client type.
GETRetrieve stats by a specific client type.
GETRetrieve email statistics by mailbox provider.
GETRetrieve email statistics by browser.

This endpoint allows you to send email over SendGrid’s v3 Web API,

FreemiumThis API has a free, limited plan and paid plans. You can subscribe directly to it from Rakuten RapidAPI.
Sign up to test this endpoint
Log in
Header Parameters
Required Parameters
REQUIREDSend email payload. For optional payload parameters visit
Request Snippet"")
.header("X-RapidAPI-Host", "undefined")
.header("X-RapidAPI-Key", "undefined")
.header("Content-Type", "application/json")
.send({"personalizations":[{"to":[{"email":""}],"subject":"Hello, World!"}],"from":{"email":""},"content":[{"type":"text/plain","value":"Hello, World!"}]})
.end(function (result) {
  console.log(result.status, result.headers, result.body);
Sample Response


Log inSign up

Install SDK for NodeJS


To utilize unirest for node.js install the the npm module:

$ npm install unirest

After installing the npm package you can now start simplifying requests like so:

var unirest = require('unirest');

Creating Request"")
.header("X-RapidAPI-Host", "undefined")
.header("X-RapidAPI-Key", "undefined")
.header("Content-Type", "application/json")
.send({"personalizations":[{"to":[{"email":""}],"subject":"Hello, World!"}],"from":{"email":""},"content":[{"type":"text/plain","value":"Hello, World!"}]})
.end(function (result) {
  console.log(result.status, result.headers, result.body);
OAuth2 Authentication
Client ID
Client Secret
OAuth2 Authentication

Sign up for free

to test this endpoint

Join the world’s largest API marketplace with over half a million developers and thousands of APIs.
Testfrom the browser
Connectusing code snippets
Managefrom one dashboard