Log In
  • Docs Home
  • Glossary
  • Support
  • Log In
  • Sign Up
Sign Up
  • Docs Home
  • User Guide
    • SendGrid Overview
    • Legacy Email Activity
    • Email Activity Feed
    • SendGrid for Mobile
      • Dashboard
      • Email Activity for Mobile
      • Suppression Lists
      • Subuser Management
      • SendGrid for mobile
    • Legacy Newsletter
      • Legacy Newsletter Sunset
    • Marketing Campaigns
      • Overview
      • How to Send Email
      • Create and Manage Unsubscribe Groups
      • Notifications
      • Marketing Templates
      • Design & Code Editor
      • Senders
      • Using Custom Fields
      • A/B Testing Your Campaign
      • Campaign Statistics
      • Old Editor Sunset
      • Managing Contacts
        • Building your Contact list
        • Adding Contacts
        • Formatting a CSV
        • Managing Contact Lists
        • Segmenting your Contacts
    • Statistics
      • Overview
      • Browser
      • Browser Comparison
      • Categories
      • Category Comparison
      • Device
      • Geographic
      • Global
      • Mailbox Provider
      • Mailbox Provider Comparison
      • Inbound Parse
      • Subuser Statistics
      • Subuser Comparison
    • Suppressions
      • Suppressions Overview
      • Unsubscribe Groups
      • Blocks
      • Bounces
      • Global Unsubscribes
      • Group Unsubscribes
      • Invalid Emails
      • Recipient Subscription Preferences
      • Spam Reports
    • Transactional Templates
      • How to send an email with Dynamic Transactional Templates
      • Migrating from Legacy Templates
      • Create and Edit Transactional Templates
      • Create and edit Dynamic Transactional Templates
      • Using Handlebars
    • Settings
      • Account Details
      • Alerts
      • API Keys
      • Billing
      • Canceling your account
      • Dedicated IP Addresses
      • IP Access Management
      • Warming Up an IP Address
      • Mail
      • Inbound Parse
      • Partners
      • Reading your invoice
      • Resetting your username and password
      • Subusers
      • Sales Taxes and Tax-Exempt Status
      • Teammates
      • Tracking
      • Two-Factor Authentication
      • Sender authentication
        • How to set up domain authentication
        • How to set up link branding
        • How to set up reverse DNS
        • Troubleshooting
        • DNS Providers
    • Transactional Email
      • Transactional Email
      • Transactional Email Unsubscribes
  • API
    • Getting Started with the SendGrid API
    • API Reference Index
    • SendGrid API v3
    • SMTP API
      • How to Send an SMTP Email
      • Integrating with the SMTP API
      • Building an SMTP Email
      • How to use a Transactional Template with the SMTP API
      • Scheduling Parameters
      • Section Tags
      • Substitution Tags
      • Suppression Groups
      • Unique Arguments
      • Settings (Filters)
      • Categories
      • Errors and Troubleshooting
    • Web API v2
      • Web API Overview
      • Using the Web API
      • Blocks
      • Bounces
      • Filter Commands
      • Filter Settings
      • Invalid Emails
      • v2 Mail Send
      • Profile
      • Spam Reports
      • Timezone
      • Unsubscribes
      • Customer Subuser API
        • Customer Subuser API Overview
        • Subuser Management
        • Account Limits
        • Apps
        • IP Management
        • Whitelabel
        • Monitor Records
        • Statistics
        • Subuser Bounces
        • Subuser Invalid Emails
        • Subuser Spam Reports
        • Subuser Unsubscribes
        • Parse Settings
        • Authenticate a Subuser
      • Legacy Features
        • Legacy Newsletter
          • Marketing Email API Overview
          • Categories
          • Emails
          • Lists
          • Marketing Emails
          • Recipients
          • Schedule
          • Sender Address
          • Variations (A/B Testing)
          • Migration
            • Endpoint Comparison Overview
            • Categories Endpoint Comparison
            • Emails Endpoint Comparison
            • Lists Endpoint Comparison
            • Campaigns Endpoint Comparison
            • Recipients Endpoint Comparison
            • Campaigns Endpoint Comparison
            • Sender Address Endpoint Comparison
            • Variations Endpoint Comparison
        • Reseller API
          • v2 (deprecated)
            • Reseller API v2 (deprecated)
            • Retrieving As-You-Go Usage (deprecated)
            • Retrieving Invoice Usage (deprecated)
          • v1 (deprecated)
            • Reseller API v1 (deprecated)
            • Account Overview
            • Apps
            • Authenticate a Customer
            • Authenticate a Customer Subuser
            • Billing
            • Retrieving As-You-Go Usage
            • Retrieving End User Invoice
            • Customer Account Limits
            • Customer Bounces
            • Customer Invalid Emails
            • Customer Management
            • Customer Spam Reports
            • Customer Statistics
            • Customer Subuser Account Limits
            • Customer Subuser Apps
            • Customer Subuser Bounces
            • Customer Subuser Event Notification URL
            • Customer Subuser Invalid Emails
            • Customer Subuser Monitor Outgoing Email
            • Customer Subuser Parse Settings
            • Customer Subuser Spam Reports
            • Customer Subuser Statistics
            • Customer Subuser Unsubscribes
            • Customer Unsubscribes
            • Event Notification URL
            • Invoice Retrieval
            • IP Management
            • Monitor Records
            • Parse Settings
            • Pending Account Changes
            • View Available Packages
            • Whitelabel
        • Customer Subuser API
          • v1 (deprecated)
            • Customer Subuser API v1 (deprecated)
            • Event Notification URL
            • Invalid Emails
            • Subuser Bounces
            • Subuser Spam Reports
            • Subuser Unsubscribes
      • Reseller API
        • Reseller API Overview
        • Account Changes
        • Account Overview
        • Apps
        • Authenticate a Customer
        • Authenticate a Customer Subuser
        • Customer Account Limits
        • Customer Bounces
        • Customer Invalid Emails
        • Customer Management
        • Customer Spam Reports
        • Customer Statistics
        • Customer Timezone
        • Customer Unsubscribes
        • Event Notification URL
        • Invoice Retrieval
        • IP Management
        • Monitor Records
        • Multiple Credentials
        • Parse Settings
        • View Available Packages
        • Whitelabel
        • Reseller Customer Subuser API
          • Reseller Customer Subuser API
          • Customer Subuser Account Limits
          • Customer Subuser Apps
          • Customer Subuser Bounces
          • Customer Subuser Event Notification URL
          • Customer Subuser Invalid Emails
          • Customer Subuser Monitor Outgoing Email
          • Customer Subuser Parse Settings
          • Customer Subuser Spam Reports
          • Customer Subuser Statistics
          • Customer Subuser Timezone
          • Customer Subuser Unsubscribes
      • Reseller Haiku API
        • Reseller Haiku API Overview
        • Customer Provision
        • Customer Change
        • Customer Deprovision
        • Customer Single Sign On
      • Statistics
        • General Statistics
        • Advanced Statistics
    • Web API v3
      • API v3 Overview
      • Alerts API
      • Blocks API
      • Bounces API
      • Invalid Emails API
      • Spam Reports API
      • Subusers API
      • Teammates API
      • Users API
      • Cancel Scheduled Sends
      • IP Access Management
      • API Keys
        • API Keys
        • API Key Permissions List
        • API Key Permissions
      • Marketing Campaigns
        • Marketing Campaigns API Overview
        • Campaigns API
        • Contacts API
        • Sender Identities API
      • How To Use The Web API v3
        • Overview
        • Authentication
        • Requests
        • Responses
        • Rate Limits
        • Errors
      • Categories
        • Categories
      • IP Management
        • IP Addresses
        • IP Pools
        • IP Management Overview
        • Automated IP Warmup
      • Mail
        • Overview
        • Status Codes & Errors
      • Settings
        • Settings Overview
        • Mail
        • Partner
        • Tracking
      • Stats
        • Stats Overview
        • Global Stats
        • Category Stats
        • Subuser Stats
        • Advanced Stats
        • Parse Webhook Stats
      • Suppression Management
        • Suppression Management Overview
        • Unsubscribe Groups
        • Suppressions
        • Global Unsubscribes
      • Transactional Templates
        • Transactional Templates Overview
        • Templates
        • Versions
      • Webhooks
        • Event Webhook
        • Parse API
      • Whitelabel
        • Domains
        • IPs
        • Links
    • Parse Webhook
      • Inbound Email Parse Webhook
  • Integrate
    • Integrate with SendGrid
    • API Libraries
    • Tutorials
      • Analyze, Visualize, and Store SendGrid Event Data with Keen IO
      • Building Serverless Apps with Form.io + SendGrid
      • Using SendGrid with BriteVerify
      • Using CloudRail to integrate SendGrid into your application
      • Deploying a SendGrid App on Engine Yard
      • Using SendGrid with OpenShift
      • Building an iOS App on Windows Azure
      • SendGrid EventKit
      • Sync your SendGrid contacts using PieSync
      • Segment
        • SendGrid Source
      • WordPress
        • Index
        • SendGrid's WordPress Plugin
        • WordPress Subscription Widget
        • FAQ
      • Zapier
        • Index
        • Sending New Emails via SendGrid For New Gravity Forms Submissions
        • Send Emails Through SendGrid For New Caught Webhook Data
        • Sending SendGrid Emails For New PostgreSQL Custom Query Row Matches
        • Sending SendGrid Emails From New Google Sheets Rows
        • Sending Emails From SendGrid to Tagged Infusionsoft Contacts
        • Sending SendGrid Email When New Firebase Child Records Are Added
    • Code Examples
      • Code Examples Index
      • Webhook Examples
        • Webhook Examples Index
        • C#
        • Go
        • Node.js
        • PHP
        • Python
      • SMTP API Header Examples
        • SMTP API Examples Index
        • Go
        • Node.js
        • Perl
        • PHP
        • Python
        • Ruby
      • v2 Mail
        • v2 Code Examples Index
        • C#
        • Go
        • Java
        • v2 Node.js
        • Perl
        • PHP
        • Python
        • Ruby
      • v3 Mail
        • v3 Code Examples Index
        • C#
        • Go
        • Java
        • Node.js
        • PHP
        • Python
        • Ruby
    • Frameworks
      • Frameworks Index
      • CakePHP
      • CodeIgniter
      • Django
      • Laravel
      • Ruby on Rails
      • Symfony
      • Zend
    • Mail Clients
      • Mail Clients Index
      • Apple Mail
      • Outlook 2007
      • Outlook 2013
      • Thunderbird
    • Mail Servers
      • Mail Servers Index
      • Exchange 2010
      • Exim 4
      • Microsoft IIS 7.5
      • Postfix
      • Qmail
      • Sendmail
      • ssmtp
    • Open Source Apps
      • Open Source Apps Index
      • Drupal
      • Joomla
      • Magento
      • MODX
      • phpBB
    • Other
      • Other Integrations Index
      • Interspire Email Marketer
      • SugarCRM
    • Partners
      • Partner Integrations Index
      • Amazon Marketplace
      • Google
      • Microsoft Azure
      • Migrating from a partner account
      • SendGrid Extension for Magento 2.0
  • Classroom
    • Overview
    • Basics
      • Basics Index
      • Inbound Parse Webhook
        • Setting Up The Inbound Parse Webhook
      • API
        • API Key Permissions
        • Cross Origin Resource Sharing (CORS)
        • Does Sendgrid offer a sandbox or test environment?
        • How do I Integrate with SendGrid?
        • How to Create a Subuser with the API
        • What are the SendGrid APIs and what do they do?
        • What is my API key?
      • Account
        • Account Sign Up FAQs
        • How do I add more emails to my account?
        • How do I reset my password?
        • Why can’t I reset my password if my account is not provisioned?
      • Email Infrastructure
        • Does SendGrid support end-to-end TLS?
        • Email Flow
        • Everything about DMARC
        • SSL vs. TLS
      • Marketing Campaigns
        • Unsubscribe, Sender ID, and Weblink System Tags
        • How to Leverage Your Engagement Statistics
        • Marketing Campaigns FAQs
        • Why can't I access Sendgrid's Marketing Campaigns when using 3rd party services/platforms?
        • Adding Unsubscribe Links in Marketing Campaigns
      • Misc
        • A Sendgrid user is spamming me, how do I report them?
        • SendGrid OEM Process
        • How to contact SendGrid support
        • What is the difference between Marketing and Transactional Emails?
        • Your Reputation... What is it?
      • Security
        • You wouldn't share your toothbrush.... don't share your password!
        • Is Sendgrid HIPAA Compliant?
        • Is Sendgrid PCI compliant?
        • Keeping Your Registration Form Secure
        • Passwords
        • How can I securely upload or download lists of suppression addresses to SendGrid?
        • Security Checklist
        • SendGrid Security FAQs
    • Build
      • Build Index
      • Add Content
        • Attachments
        • Can I use substitution tags in subject lines?
        • Can I change email content after I send?
        • Content Delivery Networks
        • Adding a Custom SSL configuration
        • Embedding Videos in Your Emails
        • How do I add a list-unsubscribe header to my emails?
        • Link Shorteners
        • Substitution and Section Tags
        • Universal Links
        • What's the recommended message size limit?
      • Choose Content
        • Adaptive Email Content
        • Brand Consistency - Why It's Important
        • Gmail Promotions Tab
        • Personalization - Making Your Messages Count
      • Format Content
        • HTML Formatting Issues
        • HTML Rendering - The Do's and Dont's of Cross-Platform Email Design
        • Plain text emails converted to HTML
    • Deliver
      • Deliverability Overview
      • Shared IP Throttling
      • Delivery Introduction
        • Email Deliverability Overview
        • Russian Data Localization Law
        • Group Unsubscribes vs Global Unsubscribes
        • The Art of Notifications
        • Unsubscribes Explained
      • Sender Authentication
        • AOL DMARC Changes / "refused due to provided DMARC Policy"
        • Gmail DMARC Changes
        • Internet Standards (SPF and DKIM) and Deliverability
        • Microsoft DMARC Changes
        • SPF: Don't Exceed Ten DNS Lookups!
        • SPF Records Explained
        • The Importance of a Physical Mailing Address
        • Yahoo DMARC Changes "Message not accepted for policy reasons"
      • Undeliverable Email
        • Google Feedback Loop (Spam Complaints)
        • Help, My emails aren't being delivered!
        • How do I whitelist emails to keep them from dropping?
        • My Emails Are Being Dropped
        • My Emails Are Going to Spam
        • Spam Trapped
        • What do I do if I'm blacklisted?
        • Why is sendgrid.net “greylisted”?
    • Send
      • Send Index
      • v3 Mail Send
        • Overview
        • cURL Examples for Common Use Cases
        • How To Migrate From v2 to v3 Mail Send
        • Personalizations
        • Sandbox Mode
        • v3 Mail Send FAQ
      • How Emails Are Sent
        • API Keys
        • Can I send from multiple domains?
        • Can I send from multiple FROM addresses?
        • Email to SMS
        • sendmail: Relay all local mail through Sendgrid
        • 550 Unauthenticated Senders Not Allowed
      • What You Can Send
        • Can I send adult content in my emails?
        • Welcome Emails: Making a Good First Impression
      • When Emails Are Sent
        • Can I stop a scheduled send?
        • Can I stop a send in progress?
        • How can I schedule emails to send at specific times?
        • Seeing a delay with your first few sends?
    • Track
      • Track Index
      • Collecting Data
        • Email Event Data with Keen IO
        • Google Analytics Demystified: GA Statistics vs SG Statistics
        • Is there a way to see the content of transactional emails I send?
        • SendGrid for New Relic
      • Clicks
        • Click Tracking & HTML Best Practices
        • Click tracking links have stopped working.
        • Click Tracking and Substitution Tags in Marketing Campaigns
        • Setting up SSL for click tracking
      • Unsubscribes
        • How do I unsubscribe a user?
        • List-Unsubscribe
        • Unsubscribe via Subscription Tracking
    • Troubleshooting
      • Troubleshooting Index
      • Account Administration
        • Suspended, Warned, Deactivated, or Banned
        • Can't access the email address on file for your SendGrid account?
        • Can't log in to your account?
        • Help, I can't find my SMTP username and password
        • Help! My account has been compromised!
        • Heroku Users - Find your SendGrid Credentials
        • How to change password when integrated via AppDirect
        • How to change the password for your SendGrid account via SoftLayer
        • How to change the password for your SendGrid add-on via Azure
        • How to change the password for your SendGrid add-on via OpenShift
        • How to change the password for your SendGrid add-on via the IBM Cloud Marketplace
        • I didn't receive the password reset email
        • IP Access Management has locked me out of my account
        • My provision was declined, what should I do?
        • Upgrade error message: "You cannot change your package at this time because your account is not active."
      • Authentication
        • How do I check the headers/raw source of an email?
        • My emails are displaying as "on behalf of" or "via" in some mail clients
      • Delivery Issues
        • Safely Test Your Sending Speed
        • Troubleshooting Delays and Latency
  • Release Notes

Getting Started With SendGrid

User Guide

Find out more about how to use every feature of SendGrid.

Integrate

Send email from your app whether it’s a CMS, framework, CRM, or your own code.

Code Examples

Code in a variety of languages to help you get going on your project.

Glossary

Email terms and definitions to help make email sending easier.

API Reference

SendGrid API

Interact with SendGrid over our updated v3 API.

SMTP API

Learn how to use SendGrid’s SMTP API to customize how your email is sent.

Event Webhook

Send data back to your server, events from your sent mail and parsed inbound mail.

Inbound Parse

Programmatically parse incoming emails.

SendGrid Pricing Try SendGrid for Free Contact Us
This is not a sandbox. These are real API calls that affect your account, possibly altering data and consuming emails.
© SendGrid / Home / Docs / Legal