Skip to main content
modiva.ai
Sign In
Python logo

Python · Python 3.9+

Python SDK for the Modiva API

A typed, idiomatic Python client for social, ads, CRM and e-commerce APIs. 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 keyView on GitHubRead the docs

Install

pip install modiva

Requires Python 3.9+. 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.

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="Hello from the Modiva Python 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 Python SDK?
Run `pip install modiva`. It requires Python 3.9+. Then set MODIVA_API_KEY in your environment (create a key in the dashboard) and instantiate the client.
Is the Python SDK free and open source?
Yes — it's MIT-licensed and published on GitHub at modiva-dev/modiva-python. Read the source, file issues and contribute.
Which integrations does the Python 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

Node.js / TypeScriptGoRubyJavaPHP.NET / C#Rust

← All Modiva SDKs

Start building with Python
Free to start · First 3 connected accounts free · API key in one click
Create free account