Ruby · Ruby 2.7+

Ruby SDK for the Modiva API

A dependency-free Ruby client for the Modiva social, ads and CRM API. One typed client reaches all 24 integrations and 280+ tools across social, ads, CRM and e-commerce — auth, retries, pagination and idempotency handled for you.

Get your API key View on GitHub Read the docs

Install

gem install modiva

Requires Ruby 2.7+. Set MODIVA_API_KEY in your environment — the client reads it automatically.

Quickstart

Connect an account in the dashboard, create an API key, then publish in a few lines.

modiva = Modiva::Client.new  # reads MODIVA_API_KEY

# List connected accounts
connections = modiva.connections.list

# Publish a post (or schedule with scheduled_at)
modiva.social.posts.create(
  connection_id: connections[0]["id"],
  text: "Hello from the Modiva Ruby SDK!"
)

What you get

One client for all 24 integrations — no library per platform.
Typed methods for posts, comments, DMs and analytics, plus a generic tool surface for every one of the 280+ tools.
Bearer-key auth from MODIVA_API_KEY; provider OAuth and token refresh handled server-side.
Automatic retries with backoff, idempotent creates, and built-in pagination.
MIT-licensed and open source on GitHub.

Frequently asked questions

How do I install the Modiva Ruby SDK?

Run `gem install modiva`. It requires Ruby 2.7+. Then set MODIVA_API_KEY in your environment (create a key in the dashboard) and instantiate the client.

Is the Ruby SDK free and open source?

Yes — it's MIT-licensed and published on GitHub at modiva-dev/modiva-ruby. Read the source, file issues and contribute.

Which integrations does the Ruby SDK support?

All of them. One client reaches every one of the 24 integrations — Instagram, TikTok, Google Ads, HubSpot, Shopify and more — through the same typed methods and a generic tool surface.

Other languages

PHP

Start building with Ruby

Free to start · First 3 connected accounts free · API key in one click

Create free account