7 SDKs to send emails in your favorite programming language

A powerful email API enables you to integrate email sending in any app or website that you’re building. You can use the API to access commonly used endpoints such as sending emails with attachments, or dive into more advanced features like creating a webhook or an inbound route.

But it can sometimes feel like you’re reinventing the wheel when you call API endpoints using your preferred programming language. The good news is that software development kits (SDKs) can save you much coding time and effort by bundling pre-built components and documentation.

Read on to learn how you can leverage official SDKs from MailerSend to reduce development time and get started with sample code to send emails and personalize them!

Integrate the email API in 3 steps

When it comes to sending transactional emails, like account notifications or order updates, you have a choice of using MailerSend’s email API or SMTP. Using SMTP is the fastest and easiest option but it’s best left for legacy applications or Internet of Things (IoT) devices.

The email API is the most powerful option as you can call on just about every endpoint of the MailerSend app from your project. Plus, you get advanced functionality like using email templates and personalization using variables—features that are not defined with the SMTP standard.

Before you dive into an SDK for your programming language, you’ll need to do some preliminary work first. Let’s add a sending domain and create an API token before covering each SDK in turn.

Step 1. Add a sending domain

To send emails with MailerSend using your own domain, you first need to verify and authenticate it.

1. Navigate to Domains in the top navigation bar and click on Add domain.

Add domain

2. Enter your domain name and click Add domain again.

3. Next, you will see the DNS records to be added to the domain’s DNS page:

  • SPF: Sends the mail server IP validation. 

  • DKIM: Like SPF, but uses cryptographic methods for validation. 

  • CNAME for Return-Path: The address where bounces and other email feedback are sent to. It is specified by the Return-Path header in an email.

If you have a domain administrator, click Share records to email the DNS records so it can be done for you. You can then jump to step 5. Lucky you! 

Otherwise, click on each field to copy it and go to the next step.

4. Log in to the sending domain’s DNS page on the hosting provider’s site and add the TXT and CNAME records that you have just copied.

5. After adding the records, toggle the option I have added the DNS records in MailerSend and click Verify domain. It can take up to 24 hours for the records to propagate, but it usually takes a few minutes.

Verify domain

Congrats, you just added your first sending domain! 🎉

For more information about troubleshooting authentication and configuring DNS settings with popular domain providers, visit this help article.

Step 2. Generate an API token

Next, you’ll need an API token to integrate MailerSend’s email API into your apps.

1. Navigate to the Domains page and click on a domain.

2. Create an API token by clicking on Generate new token.

3. Enter a name for the token, choose its permission level, and then click Create token.

Create token

When your API token is ready, scroll down to the Sending instructions section. Here are quick examples of how to send emails using cURL, PHP, Laravel, Node.js, Go, and Python. In the next section, you can find Ruby and Java as well!

Sending instructions

Step 3. Send using an SDK

Let’s hear it from the developers at The Remote Company (which MailerSend is part of) who contributed to each SDK. Who knows, you might be the next person to create a MailerSend SDK for another programming language!

How to integrate MailerSend with PHP

“I love PHP. It's fast and flexible like the best football strikers in the world! Not only that, it’s a great team player as well and empowers web development frameworks like Laravel and more.”

Tautvydas

Lead Developer at MailerSend

The official SDK supports PHP 7.4 and PHP 8 and uses PHP Standard Recommendations like HTTP Client and HTTP message interfaces. Tautvydas suggests that you install the implementations first with the following command:

composer require php-http/guzzle7-adapter nyholm/psr7

Then install the official PHP SDK:

composer require mailersend/mailersend

Here are a few examples of sending a template-based email, sending an email with an attachment, as well as personalizing emails using variables.

Send a template-based email

use MailerSend\MailerSend;
use MailerSend\Helpers\Builder\Variable;
use MailerSend\Helpers\Builder\Recipient;
use MailerSend\Helpers\Builder\EmailParams;

$mailersend = new MailerSend(['api_key' => 'key']);

$recipients = [
    new Recipient('your@client.com', 'Your Client'),
];

$variables = [
    new Variable('your@client.com', ['var' => 'value'])
];

$tags = ['tag'];

$emailParams = (new EmailParams())
    ->setFrom('your@domain.com')
    ->setFromName('Your Name')
    ->setRecipients($recipients)
    ->setSubject('Subject')
    ->setTemplateId('ss243wdasd')
    ->setVariables($variables);

$mailersend->email->send($emailParams);

Send an email with an attachment

use MailerSend\MailerSend;
use MailerSend\Helpers\Builder\Attachment;
use MailerSend\Helpers\Builder\Recipient;
use MailerSend\Helpers\Builder\EmailParams;

$mailersend = new MailerSend(['api_key' => 'key']);

$recipients = [
    new Recipient('your@client.com', 'Your Client'),
];

$attachments = [
    new Attachment(file_get_contents('attachment.jpg'), 'attachment.jpg')
];

$emailParams = (new EmailParams())
    ->setFrom('your@domain.com')
    ->setFromName('Your Name')
    ->setRecipients($recipients)
    ->setSubject('Subject')
    ->setHtml('This is the html version.')
    ->setText('This is the text version.')
    ->setAttachments($attachments);

$mailersend->email->send($emailParams);

Send an email with simple personalization

use MailerSend\MailerSend;
use MailerSend\Helpers\Builder\Variable;
use MailerSend\Helpers\Builder\Recipient;
use MailerSend\Helpers\Builder\EmailParams;

$mailersend = new MailerSend(['api_key' => 'key']);

$recipients = [
    new Recipient('your@client.com', 'Your Client'),
];

$variables = [
    new Variable('your@client.com', ['var' => 'value'])
];

$emailParams = (new EmailParams())
    ->setFrom('your@domain.com')
    ->setFromName('Your Name')
    ->setRecipients($recipients)
    ->setSubject('Subject {$var}')
    ->setHtml('This is the html version with a {$var}.')
    ->setText('This is the text version with a {$var}.')
    ->setVariables($variables);

$mailersend->email->send($emailParams);

Send an email with advanced personalization

use MailerSend\MailerSend;
use MailerSend\Helpers\Builder\Personalization;
use MailerSend\Helpers\Builder\Recipient;
use MailerSend\Helpers\Builder\EmailParams;

$mailersend = new MailerSend(['api_key' => 'key']);

$recipients = [
    new Recipient('your@client.com', 'Your Client'),
];

$personalization = [
    new Personalization('your@client.com', [
        'var' => 'variable',
        'number' => 123,
        'object' => [
            'key' => 'object-value'
        ],
        'objectCollection' => [
            [
                'name' => 'John'
            ],
            [
                'name' => 'Patrick'
            ]
        ],
    ])
];

$emailParams = (new EmailParams())
    ->setFrom('your@domain.com')
    ->setFromName('Your Name')
    ->setRecipients($recipients)
    ->setSubject('Subject {$var}')
    ->setHtml('This is the html version with a {$var}.')
    ->setText('This is the text version with a {$var}.')
    ->setPersonalization($personalization);

$mailersend->email->send($emailParams);

For more PHP code examples, including how to manage messages, recipients and tokens, visit the official SDK for PHP page.

How to integrate MailerSend with Laravel

“Laravel is my web application framework of choice. Anyone with PHP knowledge can pick it up really quickly. In fact, I spend far more time listening to Laravel podcasts than my Spotify playlists!”

Robert

Team Lead at The Remote Company

Before getting started, Robert recommends that you upgrade Guzzle to at least version 7. Once done, install the driver via composer:

composer require mailersend/laravel-driver

Set the MAILERSEND_API_KEY in your .env file:

MAILERSEND_API_KEY=

Add MailerSend as a Laravel Mailer in config/mail.php in mailers array:

'mailersend' => [
    'transport' => 'mailersend',
],

And set the environment variable MAIL_MAILER in the .env file:

MAIL_MAILER=mailersend

Finally, double-check that your FROM data is defined in the .env file:

MAIL_FROM_ADDRESS=app@yourdomain.com
MAIL_FROM_NAME="App Name"

Whew! With the preliminary setup out of the way, sending an email in Laravel requires you to create a mailable. Here’s an example that you can use:

app/Mail/TestEmail.php

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;
use Illuminate\Support\Arr;
use MailerSend\Helpers\Builder\Variable;
use MailerSend\Helpers\Builder\Personalization;
use MailerSend\LaravelDriver\MailerSendTrait;

class TestEmail extends Mailable
{
    use Queueable, SerializesModels, MailerSendTrait;

    public function build()
    {
        $to = Arr::get($this->to, '0.address');

        return $this->view('emails.test_html')
            ->text('emails.test_text')
            ->attachFromStorageDisk('public', 'example.png')
            ->mailersend(
                null,
                [
                    new Variable($to, ['name' => 'Your Name'])
                ],
                ['tag'],
                [
                    new Personalization($to, [
                        'var' => 'variable',
                        'number' => 123,
                        'object' => [
                            'key' => 'object-value'
                        ],
                        'objectCollection' => [
                            [
                                'name' => 'John'
                            ],
                            [
                                'name' => 'Patrick'
                            ]
                        ],
                    ])
                ]
            );
    }
}

To add media and attachments to emails, this can be simply done through standard Laravel methods.

To access templates, variables and tags in the email API, use the MailerSendTrait trait that adds a mailersend method to the mailable. This method enables you to, for example, personalize your emails and engage your recipients further. Send the trait using the following code:

use App\Mail\TestEmail;
use Illuminate\Support\Facades\Mail;

Mail::to('recipient@domain.com')->send(new TestEmail());

For a step-by-step guide to sending emails in Laravel using the API or SMTP, check out this blog article. More information can be found at the official driver for Laravel page and the Laravel Mail documentation.

How to integrate MailerSend with Node.js

“JavaScript is the de facto standard for front-end web development—and Node.js takes it further by letting it run outside the browser. Let there be JavaScript everywhere!”

Ahmed

Developer at MyZenTeam

First start by installing the official Node.js SDK with the command:

npm install mailersend

Then check out these examples of sending a template-based email, sending an email with an attachment, as well as personalizing emails using variables.

Send a template-based email

const Recipient = require("mailersend").Recipient;
const EmailParams = require("mailersend").EmailParams;
const MailerSend = require("mailersend");

const mailersend = new MailerSend({
    api_key: "key",
});

const recipients = [
  new Recipient("your@client.com", "Your Client")
];

const emailParams = new EmailParams()
      .setFrom("your@domain.com")
      .setFromName("Your Name")
      .setRecipients(recipients)
      .setTemplateId('templateId')
      .setSubject("Subject")

mailersend.send(emailParams);

Send an email with an attachment

const fs = require('fs');

const Recipient = require("mailersend").Recipient;
const EmailParams = require("mailersend").EmailParams;
const Attachment = require("mailersend").Attachment;
const MailerSend = require("mailersend");

const mailersend = new MailerSend({
    api_key: "key",
});

const recipients = [
  new Recipient("your@client.com", "Your Client")
];

const attachments = [
  new Attachment(fs.readFileSync('/path/to/file.pdf', {encoding: 'base64'}), 'file.pdf')
]

const emailParams = new EmailParams()
      .setFrom("your@domain.com")
      .setFromName("Your Name")
      .setRecipients(recipients)
      .setAttachments(attachments)
      .setSubject("Subject")
      .setHtml("This is the HTML content")
      .setText("This is the text content");

mailersend.send(emailParams);

Send an email with simple personalization

const Recipient = require("mailersend").Recipient;
const EmailParams = require("mailersend").EmailParams;
const MailerSend = require("mailersend");

const mailersend = new MailerSend({
    api_key: "key",
});

const recipients = [
  new Recipient("your@client.com", "Your Client")
];

const variables = [
  {
    email: "your@client.com",
    substitutions: [
      {
        var: 'test',
        value: 'Test Value'
      }
    ],
  }
];

const emailParams = new EmailParams()
      .setFrom("your@domain.com")
      .setFromName("Your Name")
      .setRecipients(recipients)
      .setVariables(variables)
      .setSubject("Subject, {$test}")
      .setHtml("This is the HTML content, {$test}")
      .setText("This is the text content, {$test}");

mailersend.send(emailParams);

Send an email with advanced personalization

const Recipient = require("mailersend").Recipient;
const EmailParams = require("mailersend").EmailParams;
const MailerSend = require("mailersend");

const mailersend = new MailerSend({
    api_key: "key",
});

const recipients = [
  new Recipient("your@client.com", "Your Client")
];

const personalization = [
  {
    email: "your@client.com",
    data: {
      test: 'Test Value'
    },
  }
];

const emailParams = new EmailParams()
      .setFrom("your@domain.com")
      .setFromName("Your Name")
      .setRecipients(recipients)
      .setPersonalization(personalization)
      .setSubject("Subject, {{ test }}")
      .setHtml("This is the HTML content, {{ test }}")
      .setText("This is the text content, {{ test }}");

mailersend.send(emailParams);

For more Node.js code examples, including how to manage messages, recipients and tokens, visit the official SDK for Node.js page.

How to integrate MailerSend with Go

“If I had to pick one open-source programming language, it'll have to be Go. I love how it was born out of an immediate need for a new codebase to manage the growing infrastructure at Google.”

Robert

Team Lead at The Remote Company

Start by installing the Go SDK with the following command:

$ go get github.com/mailersend/mailersend-go

Robert recommends that you use Go modules with the SDK as well. 

Then check out these examples of sending a template-based email, sending an email with an attachment, as well as personalizing emails using variables.

Send a template-based email

package main

import (
    "context"
    "fmt"
    "time"

    "github.com/mailersend/mailersend-go"
)

var APIKey = "Api Key Here"

func main() {
	// Create an instance of the mailersend client
	ms := mailersend.NewMailersend(APIKey)

	ctx := context.Background()
	ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()
	
	subject := "Subject"

	from := mailersend.From{
		Name:  "Your Name",
		Email: "your@domain.com",
	}

	recipients := []mailersend.Recipient{
		{
			Name:  "Your Client",
			Email: "your@client.com",
		},
	}

	variables := []mailersend.Variables{
		{
			Email: "your@client.com",
			Substitutions: []mailersend.Substitution{
				{
					Var:   "foo",
					Value: "bar",
				},
			},
		},
	}

	message := ms.Email.NewMessage()

	message.SetFrom(from)
	message.SetRecipients(recipients)
	message.SetSubject(subject)
	message.SetTemplateID("template-id")
	message.SetSubstitutions(variables)
	
	res, _ := ms.Email.Send(ctx, message)

	fmt.Printf(res.Header.Get("X-Message-Id"))

}

Send an email with an attachment

package main

import (
	"bufio"
	"context"
	"encoding/base64"
	"fmt"
	"io/ioutil"
	"os"
	"time"

    "github.com/mailersend/mailersend-go"
)

var APIKey = "Api Key Here"

func main() {
	// Create an instance of the mailersend client
	ms := mailersend.NewMailersend(APIKey)

	ctx := context.Background()
	ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()

	subject := "Subject"
	text := "This is the text content"
	html := "<p>This is the HTML content</p>"

	from := mailersend.From{
		Name:  "Your Name",
		Email: "your@domain.com",
	}

	recipients := []mailersend.Recipient{
		{
			Name:  "Your Client",
			Email: "your@client.com",
		},
	}

	tags := []string{"foo", "bar"}

	message := ms.Email.NewMessage()

	message.SetFrom(from)
	message.SetRecipients(recipients)
	message.SetSubject(subject)
	message.SetHTML(html)
	message.SetText(text)
	message.SetTags(tags)

	// Open file on disk.
	f, _ := os.Open("./file.jpg")

	reader := bufio.NewReader(f)
	content, _ := ioutil.ReadAll(reader)

	// Encode as base64.
	encoded := base64.StdEncoding.EncodeToString(content)

	attachment := mailersend.Attachment{Filename: "file.jpg", Content: encoded}

	message.AddAttachment(attachment)

	res, _ := ms.Email.Send(ctx, message)

	fmt.Printf(res.Header.Get("X-Message-Id"))

}

Send an email with simple personalization

package main

import (
    "context"
    "fmt"
    "time"

    "github.com/mailersend/mailersend-go"
)

var APIKey = "Api Key Here"

func main() {
	// Create an instance of the mailersend client
	ms := mailersend.NewMailersend(APIKey)

	ctx := context.Background()
	ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()
	
	subject := "Subject {$var}"
	text := "This is the text version with a {$var}."
	html := "<p>This is the HTML version with a {$var}.</p>"

	from := mailersend.From{
		Name:  "Your Name",
		Email: "your@domain.com",
	}
	
	recipients := []mailersend.Recipient{
		{
			Name:  "Your Client",
			Email: "your@client.com",
		},
	}
	
	variables := []mailersend.Variables{
		{
			Email: "your@client.com",
			Substitutions: []mailersend.Substitution{
				{
					Var: "value",
				},
			},
		},
	}

	message := ms.Email.NewMessage()

	message.SetFrom(from)
	message.SetRecipients(recipients)
	message.SetSubject(subject)
	message.SetText(text)
	message.SetHTML(html)
	
	message.SetSubstitutions(variables)
	
	res, _ := ms.Email.Send(ctx, message)

	fmt.Printf(res.Header.Get("X-Message-Id"))

}

Send an email with advanced personalization

package main

import (
	"context"
	"fmt"
	"time"

	"github.com/mailersend/mailersend-go"
)

var APIKey = "Api Key Here"

func main() {
	// Create an instance of the mailersend client
	ms := mailersend.NewMailersend(APIKey)

	ctx := context.Background()
	ctx, cancel := context.WithTimeout(ctx, 5*time.Second)
	defer cancel()
	
	subject := "Subject {{ var }}"
	text := "This is the text version with a {{ var }}."
	html := "<p>This is the HTML version with a {{ var }}.</p>"

	from := mailersend.From{
		Name:  "Your Name",
		Email: "your@domain.com",
	}

	recipients := []mailersend.Recipient{
		{
			Name:  "Your Client",
			Email: "your@client.com",
		},
	}

	personalization := []mailersend.Personalization{
		{
			Email: "your@client.com",
			Data: map[string]interface{}{
				"Var":   "value",
			},
		},
	}

	message := ms.Email.NewMessage()

	message.SetFrom(from)
	message.SetRecipients(recipients)
	message.SetSubject(subject)
	message.SetText(text)
	message.SetHTML(html)
	
	message.SetPersonalization(personalization)

	res, _ := ms.Email.Send(ctx, message)

	fmt.Printf(res.Header.Get("X-Message-Id"))

}

For more Go code examples, including how to manage messages, recipients and tokens, visit the official SDK for Go page.

How to integrate MailerSend with Python

“Out of the blue, I once volunteered to clean a beach full of trash here in Greece. To me, Python represented that beach when everything was done—clear, beautiful and easy on the eyes.”

Alex

SRE at The Remote Company

Before using the Python SDK, Alex suggests that you have the following in place first:

  • Python 3.6.1 or higher

  • Python pip

  • MailerSend API token in a MAILERSEND_API_KEY environment variable

All good? Install the SDK by issuing the following command:

$ python -m pip install mailersend

Next, get started with these examples of sending a template-based email, sending an email with an attachment, as well as personalizing emails using variables.

Send a template-based email

from mailersend import emails

mailer = emails.NewEmail()

# define an empty dict to populate with mail values
mail_body = {}

mail_from = {
    "name": "Your Name",
    "email": "your@domain.com",
}

recipients = [
    {
        "name": "Your Client",
        "email": "your@client.com",
    }
]


variables = [
    {
        "email": "your@client.com",
        "substitutions": [
            {
                "var": "foo",
                "value": "bar"
            },
        ]
    }
]


mailer.set_mail_from(mail_from, mail_body)
mailer.set_mail_to(recipients, mail_body)
mailer.set_subject("Hello from {$company}", mail_body)
mailer.set_template("templateID", mail_body)
mailer.set_simple_personalization(variables, mail_body)

mailer.send(mail_body)

Send an email with an attachment

from mailersend import emails
import base64

mailer = emails.NewEmail()

# define an empty dict to populate with mail values
mail_body = {}

mail_from = {
    "name": "Your Name",
    "email": "your@domain.com",
}

recipients = [
    {
        "name": "Your Client",
        "email": "your@client.com",
    }
]

variables = [
    {
        "email": "your@client.com",
        "substitutions": [
            {
                "var": "foo",
                "value": "bar"
            },
        ]
    }
]

attachment = open('path-to-file', 'rb')
att_read = attachment.read()
att_base64 = base64.b64encode(bytes(att_read))
attachments = [
    {
        "id": "my-attached-file",
        "filename": "file.jpg",
        "content": f"{att_base64.decode('ascii')}"
    }
]

mailer.set_mail_from(mail_from, mail_body)
mailer.set_mail_to(recipients, mail_body)
mailer.set_subject("Hello from {$foo}", mail_body)
mailer.set_html_content("This is the HTML content, {$foo}", mail_body)
mailer.set_plaintext_content("This is the text content, {$foo}", mail_body)
mailer.set_simple_personalization(variables, mail_body)
mailer.set_attachments(attachments, mail_body)

mailer.send(mail_body)

Send an email with simple personalization

from mailersend import emails

mailer = emails.NewEmail()

# define an empty dict to populate with mail values
mail_body = {}

mail_from = {
    "name": "Your Name",
    "email": "your@domain.com",
}

recipients = [
    {
        "name": "Your Client",
        "email": "your@client.com",
    }
]

variables = [
    {
        "email": "your@client.com",
        "substitutions": [
            {
                "var": "foo",
                "value": "bar"
            },
        ]
    }
]


mailer.set_mail_from(mail_from, mail_body)
mailer.set_mail_to(recipients, mail_body)
mailer.set_subject("Hello from {$foo}", mail_body)
mailer.set_html_content("This is the HTML content, {$foo}", mail_body)
mailer.set_plaintext_content("This is the text content, {$foo}", mail_body)
mailer.set_simple_personalization(variables, mail_body)

mailer.send(mail_body)

Send an email with advanced personalization

from mailersend import emails

mailer = emails.NewEmail()

# define an empty dict to populate with mail values
mail_body = {}

mail_from = {
    "name": "Your Name",
    "email": "your@domain.com",
}

recipients = [
    {
        "name": "Your Client",
        "email": "your@client.com",
    }
]

personalization = [
    {
        "email": "test@mailersend.com",
        "data": {
        "var": "value",
        "boolean": True,
        "object": {
            "key" : "object-value"
        },
        "number": 2,
        "array": [
            1,
            2,
            3
        ]
        }
    }
    ]


mailer.set_mail_from(mail_from, mail_body)
mailer.set_mail_to(recipients, mail_body)
mailer.set_subject("Hello from {$company}", mail_body)
mailer.set_html_content("This is the HTML content, {$name}", mail_body)
mailer.set_plaintext_content("This is the text content, {$name}", mail_body)
mailer.set_advanced_personalization(personalization, mail_body)

mailer.send(mail_body)

For more Python code examples, including how to manage messages, recipients and tokens, visit the official SDK for Python page.

How to integrate MailerSend with Ruby

“Traffic jams in Belgrade are just horrible. Ruby, on the other hand, is the total opposite of that. It's simple, elegant and gets me from point A to B with a smile!”

Nikola

CTO at The Remote Company

To send emails in Ruby, install the official SDK with the following command:

gem install mailersend-ruby

Nikola recommends that you create a .env file with an API_TOKEN variable or enable it system-wide. Here’s an example of how the token should look.

Then initialize it in your Ruby file with require "mailersend-ruby". Check out how it’s done with these examples of sending a template-based email, sending an email with an attachment, as well as personalizing emails using variables.

Send a template-based email

require "mailersend-ruby"

# Initialize the email class
ms_email = Mailersend::Email.new

# Add parameters
ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
ms_email.add_subject("Time")
ms_email.add_template_id(12415125)

# Send the email
ms_email.send

Send an email with an attachment

require "mailersend-ruby"

# Initialize the email class
ms_email = Mailersend::Email.new

# Add parameters
ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
ms_email.add_recipients("email" => "leslie@parksandrec.com", "name" => "Leslie")
ms_email.add_cc("email" => "chris@parksandrec.com", "name" => "Chris")
ms_email.add_bcc("email" => "andy@parksandrec.com", "name" => "Andy")
ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
ms_email.add_subject("Time")
ms_email.add_text("Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
ms_email.add_html("<b>Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")

# You can add one or multiple attachments
ms.add_attachment(content: "/Users/Jerry/Desktop/doc.pdf", filename: "doc.pdf")
ms.add_attachment(content: "/Users/Jerry/Desktop/pic.png", filename: "pic.png")

ms_email.send

Send an email with simple personalization

require "mailersend-ruby"

# Initialize the email class
ms_email = Mailersend::Email.new

# Add parameters
ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
ms_email.add_subject("Time {$test}")
ms_email.add_text("{$test} Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
ms_email.add_html("<b>{$test} Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")

variables = {
  email: 'ron@parksandrec.com',
  substitutions: [
    {
      var: 'test',
      value: 'Test Value'
    }
  ]
}

ms_email.add_variables(variables)

ms_email.send

Send an email with advanced personalization

require "mailersend-ruby"

# Initialize the email class
ms_email = Mailersend::Email.new

# Add parameters
ms_email.add_recipients("email" => "ron@parksandrec.com", "name" => "Ron")
ms_email.add_from("email" => "april@parksandrec.com", "name" => "April")
ms_email.add_subject("Time {{ test }}")
ms_email.add_text("{{ test }}Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.")
ms_email.add_html("<b>{{ test }}Time is money, money is power, power is pizza, and pizza is knowledge. Let's go.</b>")

personalization = {
  email: 'ron@parksandrec.com',
  data: {
    test: 'Test Value'
  }
}

ms_email.add_personalization(personalization)

ms_email.send

For more Ruby code examples, including how to manage messages, recipients and tokens, visit the official SDK for Ruby page.

How to integrate MailerSend with Java

“When I first saw Java, it was a choice between it or C++. There's no guessing which one I picked in the end. Not only is Java cooler with all the coffee references, but it’s also much simpler and faster to develop.”

John

Developer at MailerLite

Get started with the Java SDK by downloading the latest release or downloading the source and compiling it yourself.

To help you troubleshoot sending, the SDK returns a MailerSendResponse object on successful send and includes the ID of the sent message. For failed sendings, it gives a MailerSendException and includes the response code and all errors encountered.

Here are some examples of sending a template-based email, sending an email with an attachment, as well as personalizing emails using variables.

Send a template-based email

import com.mailersend.sdk.Email;
import com.mailersend.sdk.MailerSend;
import com.mailersend.sdk.MailerSendResponse;
import com.mailersend.sdk.exceptions.MailerSendException;

public void sendEmail() {

    Email email = new Email();

    email.setFrom("name", "your email");

    Recipient recipient = new Recipient("name", "your@recipient.com");
    
    email.addRecipient(recipient);

    email.setTemplateId("Your MailerSend template ID");

    // you can add a variable for a specific recipient
    email.addVariable(recipient, "variable name", "variable value");

    // you can use the addVariable overload to add a variable to all recipients
    email.addVariable("all recipients variable name", "variable value");

    MailerSend ms = new MailerSend();

    ms.setToken("Your API token");

    try {
    
        MailerSendResponse response = ms.send(email);
        System.out.println(response.messageId);
    } catch (MailerSendException e) {

        e.printStackTrace();
    }
}

Send an email with an attachment

import com.mailersend.sdk.Email;
import com.mailersend.sdk.MailerSend;
import com.mailersend.sdk.MailerSendResponse;
import com.mailersend.sdk.exceptions.MailerSendException;

public void sendEmail() {

    Email email = new Email();

    email.setFrom("name", "your email");
    email.addRecipient("name", "your@recipient.com");
   
    email.setSubject("Email subject");

    email.setPlain("This is the text content");
    email.setHtml("<p>This is the HTML content</p>");

    // attach a file to the email
    email.attachFile("LICENSE");

    // if you already have a file object, you can attach that to the email
    File file = new File("LICENSE");
    email.attachFile(file);

    MailerSend ms = new MailerSend();

    ms.setToken("Your API token");

    try {
    
        MailerSendResponse response = ms.send(email);
        System.out.println(response.messageId);
    } catch (MailerSendException e) {

        e.printStackTrace();
    }
}

Send an email with simple personalization

import com.mailersend.sdk.Email;
import com.mailersend.sdk.MailerSend;
import com.mailersend.sdk.MailerSendResponse;
import com.mailersend.sdk.exceptions.MailerSendException;

public void sendEmail() {

    Email email = new Email();

    email.setFrom("name", "your email");

    email.setSubject("Subject {$var1} {$var2}");

    email.setPlain("This is the text version with a {$var1} and a {$var2}.")
    email.setHtml("<p>This is the HTML version with a {$var1} and a {$var2}.</p>");

    Recipient recipient = new Recipient("name", "your@recipient.com");
    
    email.addRecipient(recipient);

    email.setTemplateId("Your MailerSend template ID");

    // you can add a variable for a specific recipient
    email.addVariable(recipient, "var1", "variable");

    // you can use the addVariable overload to add a variable to all recipients
    email.addVariable("var2", "second variable");

    MailerSend ms = new MailerSend();

    ms.setToken("Your API token");

    try {
    
        MailerSendResponse response = ms.send(email);
        System.out.println(response.messageId);
    } catch (MailerSendException e) {

        e.printStackTrace();
    }
}

Send an email with advanced personalization

import com.mailersend.sdk.Email;
import com.mailersend.sdk.MailerSend;
import com.mailersend.sdk.MailerSendResponse;
import com.mailersend.sdk.exceptions.MailerSendException;

public void sendEmail() {

    Email email = new Email();

    email.setFrom("name", "your email");

    Recipient recipient = new Recipient("name", "your@recipient.com");
    
    email.addRecipient(recipient);

    email.setSubject("Subject {{ var }}");
    email.setPlain("This is the text version with a {{ var }}.");
    email.setHtml("<p>This is the HTML version with a {{ var }}.</p>");

    // you can add personalization for all recipients
    email.addPersonalization("var name", "personalization value");

    // you can add personalization for each recipient separately
    email.addPersonalization(recipient, "var2 name", "personalization value");

    // you can also add POJOs as advanced personalization provided they can be serialized to JSON via Gson and do not have any object properties
    MyPojo obj = new MyPojo();
    obj.property1 = "property 1 value";
    obj.array1 = {1, 2, 3, 4};

    email.addPersonalization("pojo", obj);

    MailerSend ms = new MailerSend();

    ms.setToken("Your API token");

    try {
    
        MailerSendResponse response = ms.send(email);
        System.out.println(response.messageId);
    } catch (MailerSendException e) {

        e.printStackTrace();
    }
}

You can find more Java code examples, including how to get activities for a domain, at the official SDK for Java page.

Troubleshoot email sending

Well done for making it this far! 👏 After sending your first email with MailerSend, you can check the status of your message in the Activity tab.

Activity tab

When trying to send an email via an API request, you may come across an error that prevents the email from being sent or received. Here are some things you can do to troubleshoot email sending:

  1. Check your API token. It must be valid and authorized before you can start sending emails via API. Take a look at the Managing API tokens help article if you need more information.

  2. Review JSON formatting. If you’re using JSON parameters, check that they are properly enclosed and there are no typos.

  3. Read the API documentation. Visit MailerSend’s API documentation to learn more about endpoint authorizations, possible statuses of your emails, and validation errors.

Contribute to the SDKs

If you'd like to contribute to an official SDK, create a pull request at GitHub and our developers will take a look. Otherwise, you're free to create an SDK for other programming languages as well. Send an email to info@mailersend.com and let's talk!

Start sending with an SDK now!

Now that you’ve heard from various developers at The Remote Company, it’s time to get creative with use cases and deliver an exceptional user experience for your apps and websites. Sign up for a free MailerSend account, grab an API token, and then get coding with the SDK of your choice!

Which SDK are you going to use for your project? Share in the comments below.

Sean
I’m Sean, Content Writer at The Remote Company. Like many others, I've rediscovered the joy of cycling. My next goal is to build a bike from scratch using mail-order parts. Wish me luck.