Send Email Using Ruby | SocketLabs Developers

The SocketLabs Email Delivery Ruby library allows you to easily send any type of email message supported by our Injection API, from a simple message to a single recipient, to a complex bulk message sent to multiple recipients.

Basic Message

A basic message is an email message like you’d send from a personal email client such as Outlook. A basic message can have many recipients, including multiple, To Addresses, CC Addresses, and even BCC Addresses. You can also send a file attachment in a basic message.

require "socketlabs-injectionapi" include SocketLabs::InjectionApi include SocketLabs::InjectionApi::Message message = BasicMessage.new message.subject = "Sending A Basic Message" message.html_body = "This is the Html Body of my message." message.plain_text_body = "This is the Plain Text Body of my message." message.from_email_address = EmailAddress.new("[email protected]") # Add a To address by passing the email address message.to_email_address.push("[email protected]") # Your SocketLabs ServerId and Injection API key client = SocketLabsClient.new(10000, "YOUR-API-KEY") response = client.send(message)

Bulk Message

A bulk message usually contains a single recipient per message and is generally used to send the same content to many recipients, optionally customizing the message via the use of MergeData.

require "socketlabs-injectionapi" include SocketLabs::InjectionApi include SocketLabs::InjectionApi::Message # Your SocketLabs ServerId and Injection API key client = SocketLabsClient.new(10000, "YOUR-API-KEY") message = BulkMessage.new message.subject = "Sending A Bulk Message" message.plain_text_body = "This is the body of my message sent to %%Name%%" message.html_body = "This is the HtmlBody of my message sent to %%Name%%" message.from_email_address = EmailAddress.new("[email protected]") message.add_global_merge_data("HairColor", "{ not set }") recipient1 = BulkRecipient.new("[email protected]") recipient1.add_merge_data("Name", "Recipient1") message.add_to_recipient(recipient1) recipient2 = BulkRecipient.new("[email protected]", { :friendly_name => "Recipient #2" }) recipient2.add_merge_data("Name", "Recipient2") message.add_to_recipient(recipient2) response = client.send(message)

How to Get Started

To run these samples you will need to obtain an API Key and ServerId number from your SocketLabs Control Panel.

I don’t have a SocketLabs Account

Create Your Account

I have a SocketLabs account

Get Your API Key & Server ID

About our Code Libraries

SocketLabs’ email API plays well with your favorite platforms and development frameworks, including .NET, PHP, Java, Node.js, Python, Go, and more! As a developer, our APIs for sending email give you all the tools you need to embed powerful email functionality into your applications.

See All Code Samples on GitHub