SendGrid recently announced a new endpoint, v3/mail/send, for its SendGrid Web API which marks a "new era" for the API. SendGrid believes the new endpoint rounds out the v3 offering which enables developers to completely manage email through an API. SendGrid built the endpoint in direct response to customer feedback, support ticket analysis, and open source issues.
The new endpoint allows the same functionality as v2, with some noted additions. The most notable additions is the personalizations feature. Personalizations bundle customizable parameters for a single email into one block. Developers set default parameters for the email and then override such parameters with the preferred personalizations. SendGrid expects the feature to reduce development time significantly.
In the blog post announcement, SendGrid illustrates the new personalizations feature with an example of how an email is sent in v2 versus a v3 send. Additional v3 improvements include
- Intuitive formatting with upfront validation
- detailed error reporting for faster troubleshooting
- simplified template parameter requirements
- sandbox mode for testing
With the new release, SendGrid recommends the v3 endpoint for all current and future customers. SendGrid will keep the v2 endpoint in its docs for the time being; however, SendGrid will no longer support new features within v2. To help developers with the transition, SendGrid has published a migration guide. Further, check out the video overview and the v2/v3 comparison graphic.