Project

keplars

0.0
The project is in a healthy, maintained state
Keplars is a modern transactional email API service and AWS SES alternative. This SDK provides a simple Ruby interface to send emails across multiple priority queues (instant, high, async, bulk), manage contacts and audiences, trigger automations, verify sending domains, and verify webhook signatures. Supports retry logic with exponential backoff.
2005
2006
2007
2008
2009
2010
2011
2012
2013
2014
2015
2016
2017
2018
2019
2020
2021
2022
2023
2024
2025
2026
 Dependencies

Development

~> 3.12
~> 1.59
~> 3.19

Runtime

 Project Readme

Keplars Ruby Examples

Ruby examples for integrating Keplars email service.

SDK Install

gem install keplars
require 'keplars'

client = Keplars::Client.new(api_key: 'kms_your_api_key')

result = client.emails.send_instant(
  to: 'user@example.com',
  from: 'hello@yourdomain.com',
  subject: 'Hello!',
  html: '<h1>Hello World</h1>'
)

Examples

SDK Example (sdk-example/) — Recommended

Full Sinatra demo using the official Ruby SDK. Covers transactional emails, bulk/scheduled marketing emails, webhook signature verification, and priority queue usage.

View SDK Example →

API Example (api-example/)

Minimal script sending a single email via raw HTTP using Ruby's standard net/http library — no SDK required.

View API Example →

SMTP Example (smtp-example/)

Minimal script sending a single email via SMTP using Ruby's standard net/smtp library — no SDK required.

View SMTP Example →

Quick Start

cd sdk-example
cp .env.example .env
bundle install
ruby app.rb

Server starts on http://localhost:8080.

Prerequisites

Related Examples

License

MIT