Skip to content
SociaMesh

SDKs

TypeScript and Python clients generated from the frozen contract.

Both SDKs are generated from the same OpenAPI document as the reference, so they always match the API. A CI job regenerates them and fails if anything differs. They're published to npm and PyPI at general availability; until then, build them from the repository.

TypeScript

npm install @sociamesh/sdk
import { SociaMeshError, createSociaMesh } from "@sociamesh/sdk";

const sm = createSociaMesh({ apiKey: process.env.SOCIAMESH_API_KEY! });
try {
  const scheduled = await sm.posts.listScheduled();
} catch (err) {
  if (err instanceof SociaMeshError && err.retryable) {
    // back off and retry
  }
}

Namespaces: profiles, platforms, connect, accounts, connections, posts, media, analytics, comments, conversations, automations, webhooks, billing, apps. Errors throw SociaMeshError with status, code, retryable and requestId. Every generated operation is also exported under raw. It runs on Node 20+, Deno, Bun and edge runtimes (it uses fetch).

Python

pip install sociamesh
from sociamesh import AuthenticatedClient
from sociamesh.api.posts import validate_post
from sociamesh.models import PostRequestDto

client = AuthenticatedClient(base_url="https://api.sociamesh.com", token="sm_test_…")
result = validate_post.sync(client=client, body=PostRequestDto.from_dict({...}))

Every operation has sync, sync_detailed, asyncio and asyncio_detailed forms.

On this page