Developer SDKs

Modiva SDKs — one API client for every language

Official, open-source SDKs for Node.js, Python, Go, Ruby, Java, PHP, .NET and Rust. 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 Read the docs Browse on GitHub

Languages

Integrations

280+

Tools

MIT

Open source

Pick your language

Every SDK follows the same contract, so the docs and examples carry across languages. Install one package and you have the whole API.

go get modiva.ai/go

ai.modiva:sdk:0.1.0

Java SDK guide →

PHP 8.1+

PHP

composer require modiva/sdk

PHP SDK guide →

net8.0

.NET / C#

dotnet add package Modiva

Quickstart

Install the SDK, set MODIVA_API_KEY, and you're publishing in a few lines. Here's the same flow in Node.js and Python.

Node.js / TypeScript

import { Modiva } from "@modiva/node";

const modiva = new Modiva(); // reads MODIVA_API_KEY

// List connected accounts
const connections = await modiva.connections.list();

// Publish a post (or schedule with scheduledAt)
await modiva.social.posts.create({
  connectionId: connections[0].id,
  text: "Shipped via the Modiva SDK",
});

Python

import modiva

client = modiva.Modiva()  # reads MODIVA_API_KEY

# List connected accounts
connections = client.connections.list()

# Publish a post (or schedule with scheduled_at)
client.social.posts.create(
    connection_id=connections[0]["id"],
    text="Shipped via the Modiva SDK",
)

Why use a Modiva SDK

The SDKs wrap one unified REST API. Instead of maintaining a client, OAuth flow and token refresh for every platform, you install one package and let Modiva normalize the rest.

One client, every integration

Install a single package and reach all 24 integrations — social, ads, CRM and e-commerce. No separate library per platform.

Typed & idiomatic

Hand-written for each language — typed methods, native errors, and the conventions your ecosystem expects, not a generated wrapper.

Auth handled for you

Bearer-key auth from MODIVA_API_KEY, automatic token refresh on the server, and OAuth-as-a-service so your code never touches provider secrets.

Retries & pagination built in

429 and 5xx are retried with exponential backoff honoring Retry-After; create calls are idempotent; list endpoints auto-paginate.

Full tool surface

Typed helpers for common actions, plus a generic tools.execute() escape hatch for every one of the 280+ tools across the catalog.

MIT-licensed & open

Every SDK, the CLI and the chat adapter are open source on GitHub. Read the code, open issues, send PRs.

CLI & chat adapter

Beyond the language SDKs, the toolkit includes a command-line interface and a chat adapter — same API, different surface.

Modiva CLI

npm i -g modiva

Manage connections, posts and the full tool surface from your terminal.

Chat adapter

npm i @modiva/chat-adapter

One bot, every messaging surface — Instagram, Messenger, WhatsApp, Telegram, X and Discord behind one handler.

Frequently asked questions

Which languages does Modiva have an SDK for?

Modiva ships official, open-source SDKs for Node.js / TypeScript, Python, Go, Ruby, Java, PHP, .NET / C# and Rust — eight languages, all following the same contract. A command-line interface and a chat adapter round out the toolkit.

Are the SDKs free and open source?

Yes. Every Modiva SDK, the CLI and the chat adapter are MIT-licensed and published on GitHub at github.com/modiva-dev. You can read the source, file issues and contribute.

Do I need a different SDK for each integration?

No — that's the point. One SDK is a single client for all 24 integrations. Instagram, TikTok, Google Ads, HubSpot, Shopify and every other platform are reached through the same typed methods and the generic tool surface.

How do I authenticate?

Create an API key in the dashboard (MCP keys), then set MODIVA_API_KEY in your environment. The SDK reads it automatically, or you can pass it to the client constructor. Provider OAuth and token refresh are handled by Modiva — your code never sees provider credentials.

Can I use the Modiva API without an SDK?

Yes. Everything is available over a plain REST API, and AI agents can call the same capabilities through the hosted MCP server. The SDKs are a typed convenience layer on top of the same endpoints.

What if my language isn't listed?

Any HTTP client works against the REST API — the SDKs simply add types, retries and pagination. The OpenAPI spec and llms.txt in the docs make it straightforward to generate or hand-roll a client.

Keep exploring

API docs →MCP servers →All integrations →Social media API →

Ship your first integration today

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

Create free account