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: 'recipient@example.com',
  from: 'sender@example.com',
  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("test@example.com", "Example User");
_20        var subject = "Sending with Twilio SendGrid is Fun";
_20        var to = new EmailAddress("test@example.com", "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", "test@example.com")
_28	subject := "Sending with Twilio SendGrid is Fun"
_28	to := mail.NewEmail("Example User", "test@example.com")
_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("test@example.com");
_26    String subject = "Sending with Twilio SendGrid is Fun";
_26    Email to = new Email("test@example.com");
_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: 'test@example.com',
_22  from: 'test@example.com', // 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("test@example.com", "Example User");
_17$email->setSubject("Sending with Twilio SendGrid is Fun");
_17$email->addTo("test@example.com", "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("test@example.com")
_14to_email = To("test@example.com")
_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: 'test@example.com')
_15to = SendGrid::Email.new(email: 'test@example.com')
_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