← Back to Marketplace

SendGrid

Bearer

Transactional and marketing email at scale. Trusted by 80,000+ companies.

https://api.sendgrid.com
OVERVIEW

SendGrid (by Twilio) provides a REST API for sending transactional email (order confirmations, password resets, notifications) and marketing email (newsletters, campaigns). It handles deliverability, tracking, and bounce management.

The v3 API uses JSON bodies and Bearer token auth. The Mail Send endpoint supports templates, personalization, attachments, and scheduling. Stats endpoints give you open rates, click rates, and bounce data.

GET YOUR API KEY

Authentication setup

  1. Go to app.sendgrid.com and sign in
  2. Navigate to Settings → API Keys
  3. Click Create API Key
  4. Choose Full Access or Restricted Access with specific scopes
  5. Copy the key. It starts with SG.
Token format SG....
Auth type bearer
QUICK CONNECT

Create a connection in one request.

CONNECT SENDGRID
POST /connections Authorization: Bearer $TOKEN Content-Type: application/json { "name": "SendGrid", "base_url": "https://api.sendgrid.com", "auth_type": "bearer", "auth_config": {"token": "SG...."} } → {"id": "cn_xxxxxxxx", "name": "SendGrid"}
KEY ENDPOINTS

What you can call via proxy.

MethodPathDescription
POST /v3/mail/send Send an email (transactional or marketing)
GET /v3/stats Get aggregate email statistics
GET /v3/suppression/bounces List bounced email addresses
GET /v3/suppression/unsubscribes List unsubscribed recipients
GET /v3/templates List dynamic email templates
POST /v3/marketing/contacts Add or update marketing contacts
EXAMPLE

Send Email

PROXY CALL
POST /proxy/cn_xxxxxxxx/v3/mail/send Authorization: Bearer $TOKEN Content-Type: application/json { "personalizations": [{ "to": [{"email": "user@example.com"}] }], "from": {"email": "noreply@yourapp.com"}, "subject": "Welcome to our platform", "content": [{ "type": "text/plain", "value": "Thanks for signing up!" }] } 202 Accepted (empty body, email queued for delivery)
USE CASES

What people build with SendGrid.

Transactional Email

Password resets, order confirmations, welcome emails. Reliable delivery at any scale.

Marketing Campaigns

Send newsletters and campaigns with templates, A/B testing, and scheduling.

Deliverability Monitoring

Track bounces, spam reports, and unsubscribes to maintain sender reputation.

Email Analytics

Open rates, click rates, and engagement data across all your email programs.

← Back to Marketplace Developer Guide →
# SendGrid > Transactional and marketing email at scale. Trusted by 80,000+ companies. ## Overview SendGrid (by Twilio) provides a REST API for sending transactional email (order confirmations, password resets, notifications) and marketing email (newsletters, campaigns). It handles deliverability, tracking, and bounce management. The v3 API uses JSON bodies and Bearer token auth. The Mail Send endpoint supports templates, personalization, attachments, and scheduling. Stats endpoints give you open rates, click rates, and bounce data. - **Base URL:** https://api.sendgrid.com - **Auth type:** bearer - **Token format:** SG.... ## Get Your API Key 1. Go to app.sendgrid.com and sign in 2. Navigate to Settings → API Keys 3. Click Create API Key 4. Choose Full Access or Restricted Access with specific scopes 5. Copy the key. It starts with SG. ## Quick Connect bashcurl -X POST https://api.liteio.dev/connections \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "name": "SendGrid", "base_url": "https://api.sendgrid.com", "auth_type": "bearer", "auth_config": {"token": "SG...."} }' ## Key Endpoints MethodPathDescription POST/v3/mail/sendSend an email (transactional or marketing) GET/v3/statsGet aggregate email statistics GET/v3/suppression/bouncesList bounced email addresses GET/v3/suppression/unsubscribesList unsubscribed recipients GET/v3/templatesList dynamic email templates POST/v3/marketing/contactsAdd or update marketing contacts ## Example: Send Email bashcurl -X POST https://api.liteio.dev/proxy/cn_xxx/v3/mail/send \ -H "Authorization: Bearer $TOKEN" \ -H "Content-Type: application/json" \ -d '{ "personalizations": [{ "to": [{"email": "user@example.com"}] }], "from": {"email": "noreply@yourapp.com"}, "subject": "Welcome to our platform", "content": [{ "type": "text/plain", "value": "Thanks for signing up!" }] }' ## Use Cases - **Transactional Email**: Password resets, order confirmations, welcome emails. Reliable delivery at any scale. - **Marketing Campaigns**: Send newsletters and campaigns with templates, A/B testing, and scheduling. - **Deliverability Monitoring**: Track bounces, spam reports, and unsubscribes to maintain sender reputation. - **Email Analytics**: Open rates, click rates, and engagement data across all your email programs. ## Links - Back to Marketplace - Developer Guide - Get API Key