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.
Send Bulk Email Without Having to Build & Maintain Your Own SMTP Email Servers
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 AccountI Have a SocketLabs Account
Get Your API Key and Server IDAbout 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.
SocketLabs 
Developers
SocketLabs is built for developers, by developers.
Reach the inbox with industry-leading deliverability.
Integrate with your application in minutes.
