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.



Content-Type Header

All responses are returned in JSON format. We specify this by sending the Content-Type header.

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


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.

HTTP/1.1 200 OK
Content-Type: application/json

Link: <>; rel="next"; title="2",
      <>; rel="prev"; title="1",
      <>; rel="last"; title="3",
      <>; rel="first"; title="1"

Rate this page:

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.

Thank you for your feedback!

Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

Sending your feedback...
🎉 Thank you for your feedback!
Something went wrong. Please try again.

Thanks for your feedback!