Email — entry 017 of 19

Sendgrid

Verified Jul 2026

SendGrid's REST API sends transactional and marketing email, manages templates and suppression lists, and reports delivery statistics, all authenticated with a Bearer API key over a Twilio-operated cloud SMTP backend. A free tier covers a small daily send volume before its metered paid plans.

transactional-emailsmtpmarketing-emailtwilio
AuthenticationAPI KeySign up with the provider to obtain credentials.
HTTPSSupportedTraffic is encrypted in transit.
CORSEnabledCallable directly from browser JavaScript.
PricingFreemiumA usable free tier exists, with paid plans for more volume.
FormatsJSONResponses can be requested as JSON.

GreatAPIs Score

Score81out of 100
Authentication15/25API key required
Pricing17/20Freemium tier available
Docs20/20Machine-readable spec file bundled
Formats9/15Single response format
Freshness20/20Verified within 6 months

Embed this badge

Scored 81 on greatapis.com
<a href="https://greatapis.com/api/sendgrid/"><img src="https://greatapis.com/badge/sendgrid.svg" alt="Scored 81 on greatapis.com"></a>

Auth quickstart

  1. Get a key at the provider
  2. Send it on every request as a headerAuthorization: <key>
  3. The exact header isn't documented — Authorization is a common default; confirm in the provider's docs.
Stored keyNo key stored

Your key is stored only in this browser (localStorage) and sent directly to the API — never to greatapis.

Endpoints

Servers
http://api.sendgrid.com/v3
Auth
Authorization
API Keys2
GET/api_keysRetrieve all API Keys belonging to the authenticated user
Parameters
NameInRequiredType
limitquerynointeger
Responses
StatusDescriptionSchema
200
401
403
404
500
POST/api_keysCreate API keys
Request body

application/json

Responses
StatusDescriptionSchema
201
400
401
403
404
500
Bounces API1
GET/suppression/bouncesRetrieve all bounces
Parameters
NameInRequiredType
start_timequerynointeger
end_timequerynointeger
Acceptheaderyesstring
Responses
StatusDescriptionSchema
200
401global_error_response_schema
Contacts1
GET/marketing/contactsGet Sample Contacts
Responses
StatusDescriptionSchema
200
400
401
403
404
500
Lists2
GET/marketing/listsGet All Lists
Parameters
NameInRequiredType
page_sizequerynonumber
page_tokenquerynostring
Responses
StatusDescriptionSchema
200
POST/marketing/listsCreate List
Request body

application/json

Responses
StatusDescriptionSchema
200list
400
Mail Send1
POST/mail/sendv3 Mail Send
Request body

application/json

Responses
StatusDescriptionSchema
202
400
401
403
404
413
500
Sender Identities API2
GET/sendersGet all Sender Identities
Responses
StatusDescriptionSchema
200
POST/sendersCreate a Sender Identity
Request body

application/json

Responses
StatusDescriptionSchema
201senderID
400
Stats1
GET/statsRetrieve global email statistics
Responses
StatusDescriptionSchema
200
Transactional Templates2
GET/templatesRetrieve paged transactional templates.
Parameters
NameInRequiredType
generationsquerynostring
page_sizequeryyesnumber
page_tokenquerynostring
Responses
StatusDescriptionSchema
200
400
POST/templatesCreate a transactional template.
Request body

application/json

Responses
StatusDescriptionSchema
201transactional_template

Try it

Developer reference

Base URLhttps://api.sendgrid.com/v3
Rate limit

Per-endpoint quotas returned via X-RateLimit-* response headers; exact ceilings vary by plan

Key endpoints
  • POST/mail/send
  • GET/templates
  • GET/stats
  • GET/suppression/bounces