Sign Up

Log In

SendGrid

FREEMIUM
By sendgridOfficial
Updated 6 hours ago
Email
7.8/10
Popularity Score
288ms
Latency
98%
Success Rate

SendGrid API Overview

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

SendGrid API V3 Overview

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

Send Mail Status Codes

Response Code Reason Description
2xx 2xx responses indicate a successful request The request that you made is valid and successful.
200 OK
202 ACCEPTED YYour message is both valid, and queued to be delivered.

Errors

Sometimes your API call will generate an error. Every response to an API call that generates an error will include an error code, the reason for the error, and an error message to help you debug your request.

Code Reason Description
4xx 4xx responses indicate an error with your request There was a problem with your request.
400 BAD REQUEST
401 UNAUTHORIZED You do not have authorization to make the request.
403 FORBIDDEN
404 NOT FOUND The resource you tried to locate could not be found or does not exist.
405 METHOD NOT ALLOWED
413 PAYLOAD TOO LARGE The JSON payload you have included in your request is too large.
429 TOO MANY REQUESTS The number of requests you have made exceeds SendGrid’s rate limitations.
5xx 5xx responses indicate an error made by SendGrid The request you made was valid, but an error occurred when SendGrid attempted to process it.
500 SERVER ERROR An error occurred on a SendGrid server.
503 SERVICE NOT AVAILABLE The SendGrid v3 Web API is not available.
Log inSign up

Install SDK for NodeJS

Installing

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

unirest.post("https://rapidprod-sendgrid-v1.p.rapidapi.com/mail/send")
.header("X-RapidAPI-Key", "undefined")
.header("Content-Type", "application/json")
.send({"personalizations":[{"to":[{"email":"[email protected]"}],"subject":"Hello, World!"}],"from":{"email":"[email protected]"},"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 freeto test this endpoint
Join the world’s largest API marketplace with over half a million developers and thousands of APIs.
DiscoverAPIs
Testfrom the browser
Connectusing code snippets
Managefrom one dashboard