Changelog

Public-facing changes that affect SDK consumers, MCP clients, or REST API callers. We don't log every internal refactor.

For version bumps that don't have a notable user-visible change, we publish the new version without a changelog entry — assume those are bugfix-only.

2026-05-20

Outbound webhooks — deferred

The outbound webhooks surface (/api/v1/webhooks/* CRUD and the events listed previously) is gated behind admin access until the production-grade at-least-once delivery pipeline ships. If you were planning an integration that subscribes to SociaHive events, hold off — the public surface is being redesigned and the timeline is open. We'll announce here when it's ready.

In the meantime, the equivalent integration patterns work today via polling the REST API (e.g. GET /api/v1/posts?status=published&since=<timestamp>) or by reading from the MCP list_* tools.

@sociahive/[email protected] on npm

First public release of the official Node / TypeScript SDK.

• Resource groups: accounts, posts, flows, analytics
• Typed request and response shapes
• Ergonomic SociaHiveError with isAuthError, isRateLimited, isNotFound, isStateError helpers
• Both CJS and ESM bundles; types field correctly ordered for TypeScript conditional resolution
• Node 18+

npm install @sociahive/sdk

[email protected] on PyPI

First public release of the official Python SDK.

• Same resource grouping as the Node SDK
• httpx-based async-capable client
• SociaHiveError exception class
• Python 3.9+

pip install sociahive

Docs site

• New documentation site at docs.sociahive.com — multi-page Fumadocs site replacing the single-file README
• Three-doors landing: AI assistants / Developers / No-code operators
• Setup guide with Tabs for each MCP client (Claude Desktop, Claude Code, Shell CLI, Local stdio)
• Developer quickstart structured as numbered Steps
• Cookbook with three runnable recipes — auto-reply comments, CSV scheduling, daily performance recap
• Flow patterns reference (seven named patterns)
• Error reference and rate limits pages

Public source repositories

• github.com/sociahive/sociahive-node — Node SDK source
• github.com/sociahive/sociahive-python — Python SDK source
• github.com/sociahive/cookbook — runnable recipe code
• github.com/sociahive/zapier-platform-app — Zapier integration scaffold

How to track future changes

• npm: npmjs.com/package/@sociahive/sdk → Versions
• PyPI: pypi.org/project/sociahive → Release history
• REST API: breaking changes go out in OpenAPI's info.version field at /api/v1/openapi.json. Subscribe to that URL in your CI if you generate types from it.
• MCP tool registry: call list_capabilities from your MCP client — tools added or removed between sessions will surface immediately.