How to use the SendGrid V3 API
Welcome to SendGrid’s Web API v3! This API is RESTful, fully featured, easy to integrate with, and offers support in 7 different languages.
Libraries
Responses
Content-Type Header
All responses are returned in JSON format. We specify this by sending the Content-Type header.
GET https://api.sendgrid.com/v3/resource HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
{
"foo": "bar"
}
Status Codes
Below is a table containing descriptions of the various status codes we currently support against various resources.
| Status Code | Description |
|---|---|
| 200 | No error |
| 201 | Successfully created |
| 204 | Successfully deleted |
| 400 | Bad request |
| 401 | Requires authentication |
| 403 | From address doesn't match Verified Sender Identity. To learn how to resolve this error, see our Sender Identity requirements. |
| 403 | You are temporarily blocked from sending emails due to repeated bad requests. |
| 406 | Missing Accept header. For example: Accept: application/json |
| 429 | Too many requests/Rate limit exceeded |
| 500 | Internal server error |
Pagination
When a request is made with a pagination query, the following data is included in the header to allow for easy traversal of previous, current, first, and last page of the data set.
GET https://api.sendgrid.com/v3/resource?limit=5&offset=0 HTTP/1.1
HTTP/1.1 200 OK
Content-Type: application/json
Link: <http://api.sendgrid.com/v3/resource?limit=5&offset=5>; rel="next"; title="2",
<http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="prev"; title="1",
<http://api.sendgrid.com/v3/resource?limit=5&offset=10>; rel="last"; title="3",
<http://api.sendgrid.com/v3/resource?limit=5&offset=0>; rel="first"; title="1"
Need some help?
We all do sometimes. Get help now from the Twilio SendGrid Support Team.
Running into a coding hurdle? Lean on the wisdom of the crowd by browsing the SendGrid tag on Stack Overflow or visiting Twilio's Stack Overflow Collective.
