Skip to content Skip to navigation Skip to topbar

SendGrid

Find the documentation, sample code, and developer tools you need to build your transactional and marketing email solutions on the platform that offers a 99% deliverability rate.

Let's build

Take the next steps with SendGrid

Send your first email

Do more with email

Get started with Marketing Campaigns

Twilio servers

Your app


const sgMail = require('@sendgrid/mail');
sgMail.setApiKey(process.env.SENDGRID_API_KEY);
const msg = {
 to: '[email protected]',
 from: '[email protected]',
 subject: 'Ahoy!',
 html: 'Ahoy, World!',
};
sgMail
 .send(msg)
 .then((error) => console.error(error));

View complete examples

Ahoy, World!

Take the next steps with SendGrid

Send your first email

Do more with email

Get started with Marketing Campaigns

Send your first email

Get started quickly with the Twilio SendGrid Mail Send API and our open-source helper libraries. The sample code below will send your first message in no time.

C#GoJavaNode.jsPHPPythonRuby


_20using System;
_20using System.Threading.Tasks;
_20using SendGrid;
_20using SendGrid.Helpers.Mail;
_20
_20class Program
_20{
_20 static async Task Main()
_20 {
_20 var apiKey = Environment.GetEnvironmentVariable("SENDGRID_API_KEY");
_20 var client = new SendGridClient(apiKey);
_20 var from = new EmailAddress("[email protected]", "Example User");
_20 var subject = "Sending with Twilio SendGrid is Fun";
_20 var to = new EmailAddress("[email protected]", "Example User");
_20 var plainTextContent = "and easy to do anywhere, even with C#";
_20 var htmlContent = "<strong>and easy to do anywhere, even with C#</strong>";
_20 var msg = MailHelper.CreateSingleEmail(from, to, subject, plainTextContent, htmlContent);
_20 var response = await client.SendEmailAsync(msg).ConfigureAwait(false);
_20 }
_20}


_28package main
_28
_28import (
_28 "fmt"
_28 "log"
_28 "os"
_28
_28 "github.com/sendgrid/sendgrid-go"
_28 "github.com/sendgrid/sendgrid-go/helpers/mail"
_28)
_28
_28func main() {
_28 from := mail.NewEmail("Example User", "[email protected]")
_28 subject := "Sending with Twilio SendGrid is Fun"
_28 to := mail.NewEmail("Example User", "[email protected]")
_28 plainTextContent := "and easy to do anywhere, even with Go"
_28 htmlContent := "<strong>and easy to do anywhere, even with Go</strong>"
_28 message := mail.NewSingleEmail(from, subject, to, plainTextContent, htmlContent)
_28 client := sendgrid.NewSendClient(os.Getenv("SENDGRID_API_KEY"))
_28 response, err := client.Send(message)
_28 if err != nil {
_28 log.Println(err)
_28 } else {
_28 fmt.Println(response.StatusCode)
_28 fmt.Println(response.Body)
_28 fmt.Println(response.Headers)
_28 }
_28}


_26import com.sendgrid.*;
_26import java.io.IOException;
_26
_26public class Example {
_26 public static void main(String[] args) throws IOException {
_26 Email from = new Email("[email protected]");
_26 String subject = "Sending with Twilio SendGrid is Fun";
_26 Email to = new Email("[email protected]");
_26 Content content = new Content("text/plain", "and easy to do anywhere, even with Java");
_26 Mail mail = new Mail(from, subject, to, content);
_26
_26 SendGrid sg = new SendGrid(System.getenv("SENDGRID_API_KEY"));
_26 Request request = new Request();
_26 try {
_26 request.setMethod(Method.POST);
_26 request.setEndpoint("mail/send");
_26 request.setBody(mail.build());
_26 Response response = sg.api(request);
_26 System.out.println(response.getStatusCode());
_26 System.out.println(response.getBody());
_26 System.out.println(response.getHeaders());
_26 } catch (IOException ex) {
_26 throw ex;
_26 }
_26 }
_26}


_22const sgMail = require('@sendgrid/mail');
_22sgMail.setApiKey(process.env.SENDGRID_API_KEY);
_22
_22const msg = {
_22 to: '[email protected]',
_22 from: '[email protected]', // Use the email address or domain you verified above
_22 subject: 'Sending with Twilio SendGrid is Fun',
_22 text: 'and easy to do anywhere, even with Node.js',
_22 html: '<strong>and easy to do anywhere, even with Node.js</strong>',
_22};
_22
_22(async () => {
_22 try {
_22 await sgMail.send(msg);
_22 } catch (error) {
_22 console.error(error);
_22
_22 if (error.response) {
_22 console.error(error.response.body)
_22 }
_22 }
_22})();


_17$email = new \SendGrid\Mail\Mail();
_17$email->setFrom("[email protected]", "Example User");
_17$email->setSubject("Sending with Twilio SendGrid is Fun");
_17$email->addTo("[email protected]", "Example User");
_17$email->addContent("text/plain", "and easy to do anywhere, even with PHP");
_17$email->addContent(
_17 "text/html", "<strong>and easy to do anywhere, even with PHP</strong>"
_17);
_17$sendgrid = new \SendGrid(getenv('SENDGRID_API_KEY'));
_17try {
_17 $response = $sendgrid->send($email);
_17 print $response->statusCode() . "\n";
_17 print_r($response->headers());
_17 print $response->body() . "\n";
_17} catch (Exception $e) {
_17 echo 'Caught exception: '. $e->getMessage() ."\n";
_17}


_14import sendgrid
_14import os
_14from sendgrid.helpers.mail import *
_14
_14sg = sendgrid.SendGridAPIClient(api_key=os.environ.get('SENDGRID_API_KEY'))
_14from_email = Email("[email protected]")
_14to_email = To("[email protected]")
_14subject = "Sending with SendGrid is Fun"
_14content = Content("text/plain", "and easy to do anywhere, even with Python")
_14mail = Mail(from_email, to_email, subject, content)
_14response = sg.client.mail.send.post(request_body=mail.get())
_14print(response.status_code)
_14print(response.body)
_14print(response.headers)


_15require 'sendgrid-ruby'
_15include SendGrid
_15
_15from = SendGrid::Email.new(email: '[email protected]')
_15to = SendGrid::Email.new(email: '[email protected]')
_15subject = 'Sending with Twilio SendGrid is Fun'
_15content = SendGrid::Content.new(type: 'text/plain', value: 'and easy to do anywhere, even with Ruby')
_15mail = SendGrid::Mail.new(from, subject, to, content)
_15
_15sg = SendGrid::API.new(api_key: ENV['SENDGRID_API_KEY'])
_15response = sg.client.mail._('send').post(request_body: mail.to_json)
_15puts response.status_code
_15puts response.body
_15puts response.parsed_body
_15puts response.headers

Email API quickstarts

Jump to an email quickstart in your programming language of choice for a full guide on how to implement the code samples above.

Do more with email

Sending email is just the start. With SendGrid, you get rich data that allows you to establish and maintain a complete email program. You can also parse inbound messages to create rich email-based experiences for your customers.

Looking to leverage SendGrid's reliability and scale for your SMTP needs or integrate with a cloud partner such as Azure? You can do that too.

Beyond sending your first email

SMTP

Templates and dynamic data

Analytics and reporting

Account and settings

Parsing email

SDKs and tools

Get started with Marketing Campaigns

Create beautifully designed messages, personalized to each recipient, with best in class deliverability when you send with Marketing Campaigns.

Build and send with Marketing Campaigns

Manage contacts

Work with designs

Explore Twilio's other communication channels to build customer engagement infrastructure that fits the unique requirements of your business.

Messaging

Send and receive SMS/MMS and/or WhatsApp messages with the Twilio's Programmable Messaging API.

Product documentation

Voice

Quickly make and receive voice calls in your application with Twilio Voice.

Product documentation

Flex

Build your digital engagement center for sales and customer support teams with Twilio Flex.

Product documentation

SendGrid

Send your first email

Do more with email

Get started with Marketing Campaigns

Related products