Skip to main content
modiva.ai
Sign In

API Reference

Every tool, grouped by resource rather than by platform — the same surface whether you reach it over MCP, REST or an SDK. Base URL api.modiva.ai/v1.

Core
GET/profilesList profiles
POST/profilesCreate a profile
GET/accountsList connected accounts
POST/connect/urlStart a hosted OAuth flow
GET/keysList workspace MCP keys
Content & Scheduling
POST/social/postsCreate or schedule a post
GET/queueInspect the publish queue
POST/mediaUpload media for a post
POST/validatePre-flight a post per platform
Inbox
GET/messagesList inbound messages
POST/messagesSend a message or DM
GET/commentsList comments
POST/comments/:id/replyReply to a comment
GET/reviewsList & reply to reviews
Analytics
GET/analytics/postsUnified post insights
GET/analytics/inboxResponse time & volume
Example · create a post
import Modiva from "@modiva/node";

const modiva = new Modiva({ apiKey: process.env.MODIVA_KEY });

const post = await modiva.posts.create({
  profile_id: "acme",
  text: "Launching today",
});
console.log(post.id);
API Reference — Modiva