Spotlights
README
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. |