Ruby SDK

Social media SDK
for Ruby

Post, schedule, reply and report on 13 platforms from Ruby 3.0 or later, with zero dependencies.

Install in one lineFrom RubyGems, for Ruby 3.0 or later. The source is on GitHub under MIT.gem install omnisocials
Zero dependenciesBuilt entirely on the standard library (Net::HTTP, OpenSSL, JSON). Add one gem, not a dependency tree.Net::HTTP
Reads like RubyKeyword arguments everywhere: client.posts.create(content:, channels:). Responses are plain Hashes, exactly as the API sends them.client.posts.create

Fits the Ruby stack you use

The same client in Rails and Sinatra. Each example schedules a post from your own code.

Rails~/released
1class LaunchController < ApplicationController
2 def create
3 client = OmniSocials::Client.new # reads OMNISOCIALS_API_KEY
4
5 post = client.posts.create(
6 content: params[:content],
7 channels: ["instagram", "linkedin", "x"],
8 scheduled_at: "2026-11-03T09:00:00Z"
9 )
10
11 render json: post["data"]
12 end
13end

One client for the whole API

Posts, media, the inbox, analytics and webhooks sit on the same client, with the same names in every language.

Retries, errors and webhook checks built in

All eight follow one design. They retry what fails for a moment, raise a clear error for the rest and check every webhook signature.

Automatic retriesRate limits, server errors and dropped connections retry with backoff. Retry-After is respected.2 retries by default
Errors you can catchOne class per failure: authentication, validation, not found, rate limit, server and connection.RateLimitError
Timeouts you setSet the timeout, the retry count and the base URL per client. The defaults fit most apps.30 s per attempt
Webhook checksHMAC-SHA256 with a constant-time compare and a 5-minute replay window.OmniSocials::Webhooks.verify

The Ruby package

Released with the other seven SDKs from one changelog. Need another language? See all eight on the SDK page.

All SDKs
Package
omnisocials
Install
Version
0.9.0Released Oct 5, 2026
Requires
Ruby 3.0 or later
Dependencies
Zero dependencies (standard library)
Client
OmniSocials::Client.new
Responses
Hashes
Webhooks
OmniSocials::Webhooks.verify

Frequently
Asked Questions

Robert Ligthart
Robert LigthartFounder of OmniSocials
Ask me a question

Robert Ligthart
Still have a question?Ask Robert, the founder
Ask

Install it.Post today.

The SDKs, the API, the CLI and the MCP server come with every plan: $10 per seat per month, billed annually.