SendGrid

Created: 2020-05-06 11:12:18 -0700 Modified: 2020-09-16 14:58:44 -0700

READ THIS

I struggled with SendGrid for a couple of hours before determining that their documentation is horrible and that I don’t want such a frustrating experience. I typed up all of my feedback and sent it directly to one of the documentation team members responsible for it.

Getting started

If you just want to send mail, this reference with NodeJS is good. You just follow the steps there. I went from not having a SendGrid account to verifying my address to sending a mail in about 5 minutes. Note that it immediately went to spam.
- After that, if you’re just sending transactional emails, go to your SendGrid Settings → Tracking and disable Open Tracking and Click Tracking, otherwise URLs will be a jumbled mess that go through sendgrid.net first.

API v3 basics

Rate-limiting (reference): you’ll get a 429 when you hit the rate limit for a particular API

NodeJS API (reference)

Errors
- Errors aren’t really thrown; you just have to inspect the status code and the body of the response.
Basic calling
- When you call client.request, you get a promise that resolves to an array of [response, body]. The body is the same as response.body (reference)