Changelog

The API and each official SDK track versions independently.

API specification

Pagination switched from cursor to offset. Every list endpoint now takes limit + skip and returns { data[], limit, skip, total }. The previous cursor query param and the has_more / next_cursor response fields are removed. total is the full count of matching items across all pages.
All responses now carry a success flag. Success responses are { success: true, ... } — list endpoints add data/limit/skip/total, and single-resource / create / update responses nest the payload under data ({ success: true, data: {...} }). Errors are { success: false, error: { code, message, request_id } }.

Latest published versions:

SDK	Latest	Registry
Python — `blueticks`	v4.1.0	PyPI
Node.js — `blueticks`	v4.1.0	npm
PHP — `blueticks/blueticks`	v5.1.0	Packagist
Ruby — `blueticks`	v2.1.0	RubyGems
Go — `github.com/serenix-com/blueticks-go`	v2.1.0	pkg.go.dev
MCP server — `@blueticks/mcp`	v1.1.0	npm

Pagination switched from cursor to offset, matching API v2.0.0: list calls now take limit + skip and return { data[], limit, skip, total }. Replace any loop that read has_more / next_cursor.
delete() now returns a typed { id, deleted: true } resource instead of void.

Two new official SDKs joined the family: Ruby (gem install blueticks) and Go (go get github.com/serenix-com/blueticks-go). Both expose the same resources as the other clients, in each language's idiomatic style — Ruby with keyword args (client.scheduled_messages.create(...)), Go with context.Context and typed param structs (client.Chats.SendMessage(ctx, ...)). See the Quickstart and any API Reference page for per-endpoint examples in all five languages.

BluetickError.details field surfaces backend Zod validation issues with per-issue {path, code, message}. Existing try/catch code keeps working; the new field is additive.

WhatsApp tools: chats, groups, contacts, engines, utils resources land alongside the existing messages / audiences / campaigns / webhooks set.

Cursor pagination across all list endpoints. Replaces page-number pagination. Calls return {data[], has_more, next_cursor}; pass cursor back to fetch the next page.

Initial release of @blueticks/mcp — local stdio MCP server wrapping the Node SDK. Exposes 9 tools, one per Blueticks resource (scheduled_messages, chats, groups, audiences, campaigns, contacts, engine, webhooks, utils). See MCP server for setup and the authoritative tool list.

Source on GitHub: