v3 Mail Send

POST https://api.sendgrid.com/v3/mail/send

This endpoint allows you to send email over SendGrid’s v3 Web API, the most recent version of our API. If you are looking for documentation about the v2 Mail Send endpoint, please see our v2 API Reference.

• Top level parameters are referred to as global.
• Individual fields within the personalizations array will override any other global, or “message level”, parameters that are defined outside of personalizations.

SendGrid provides libraries to help you quickly and easily integrate with the v3 Web API in 7 different languages: C#, Go, Java, Node JS, PHP, Python, and Ruby.

For more detailed information about how to use the v3 Mail Send endpoint, please visit our Knowledge Center.

Mail body compression is available to some high volume accounts. Talk to your CSM if you are interested in this functionality. This works by setting up a JSON payload as defined here, then compressing it with gzip (the gzip file can be no more than 30mb). Add a Content-Encoding header, with a value of gzip, and send the gzip.as a data-binary, like this: --data-binary '@data.json.gz'

HEADERS