Skip to content
SocialMate

SocialMate Local API

Changelog & updates

The node’s version history, the GitHub repo, how to update, and where to request features or get help.

The n8n node has its own release cadence, separate from the SocialMate desktop app — it tracks the app's public API but ships on its own semver. The current published version is 2.7.0. For the app's release notes, see the main changelog.

Get the latest version

Watch the repo (or the npm package) to be notified on every release.

How to update

  1. From the n8n UISettings → Community Nodes, find SocialMate, and click Update.
  2. From npm (self-hosted n8n) —
    npm update n8n-nodes-socialmate
    then restart n8n.

Updates are safe drop-ins — operation and event names are part of the contract and don't change underneath you. After a major bump, re-test the credential to pick up any new settings.

Version history

2.7.0 2026-07-08
  • Conversational primitives — six new Message operations (Send Poll, Send Location, Send Contact, React, Send Typing, Mark Read) plus a Reply To option on every send, and three new trigger events: message.reaction, poll.vote, group.participants_updated (all Pro).
  • Message → Get Poll Results — read a poll's live tally back into a workflow.
  • Agent Memory (Pro) — Contact → Update (save what your agent learned: name, notes, tags, email, company) and Media → Set Context (cache a description/transcript your own AI produced).
  • Account → Get / Set / Clear Proxy (Pro) — per-account residential/mobile proxy routing for VPS installs.
  • AI-agent productization — every operation is usable as an n8n AI-Agent tool (usableAsTool), with rewritten, agent-grade descriptions across all operations, an afterTs poll cursor on message search, and the canonical human-agent example workflow.
  • Fixes: national-format phone numbers are rejected with a clear error (country code required); message delivery status surfaced on send results; contract fixture synced (webhook/API-key reads are admin scope).
  • First bundled test suite (unit + mock-server integration + a contract-drift guard against the app's published product-facts.json).
2.6.0 2026-07-06
  • Four importable example workflows added to the package (README-linked), including the AI-agent tool example.
  • Batch-queue ("Queue a Batch") and reminder descriptions clarified in the README and examples.
  • Documentation-only release — no operation, endpoint or event behaviour changed.
2.5.0 2026-06-29
  • Smarter chat-ID normalization — recipients can be passed as a plain phone number in international format (with country code) or a group ID, and the node resolves them the same way the app does. Operation descriptions clarified to spell out the accepted phone-number formats.
2.4.4 2026-06-28
  • Release-pipeline fix — devDependencies are stripped from the published package so supply-chain scanners only see the shipped artifact. No operation, endpoint or event behaviour changed.
2.4.3 2026-06-28
  • Published-package hygiene + n8n verification compliance — cleaned the published manifest so the node passes n8n's verified-community checks. No operation, endpoint or event behaviour changed.
2.4.2 2026-06-28
  • Release-pipeline fix (npm publish authentication) — no functional change.
2.4.1 2026-06-28
  • Group / Media Pro gating aligned with the app: Group → Leave, Media → Force Download and Media → Delete now require Pro (apiWriteEnabled) — the operation hints already said so; the README Free-vs-Pro matrix is now corrected to match.
  • Documentation/labelling-only release — no operation, endpoint or event behaviour changed. Coverage: all endpoints + all 29 trigger events.
2.4.0 2026-06-24
  • README request & response examples for the action node — Send Text, Send Media, Get AI Context, Queue a Batch and Get Anti-Ban Status, each with a "when to use" note.
  • New Send outcomes section documenting the 200 / 202 (Pro auto-queue) / 409 results and the 429-vs-auto-queue difference between Free and Pro.
  • Webhook envelope now documents the timestamp field; Get AI Context documents the full option set (format, includeTimestamps, beforeTs).
  • Documentation-only release — no operation/event behaviour changed. Coverage: all endpoints + all 29 trigger events.
2.3.0 2026-06-24
  • Added four operations: System → Get Network Status, Media → Download Thumbnail, Media → Get Download Queue, and Media → Run Cleanup (Pro).
  • Trigger tier labels corrected to match the app (tunnel.started is Pro → 9 Free events, not 10); High-Volume Mode event labels clarified.
  • Queue / Media tier corrections: Get Items & Get Batches are Free; Pause/Resume are Pro. (Media Delete was Free at this point; later moved to Pro in 2.4.1.)
2.2.0 2026-06-23
  • Full README reference: per-operation Free vs Pro matrix, webhook payload shapes, HTTP error codes (401/402/403/429), and API-key scopes.
  • Extra example workflows — a webhook-trigger auto-reply and a scheduled batch send.
  • Fixed the repository URL and added a bugs support link; credential description points to the current in-app path.
2.1.0
  • Scope-aware Account picker — the key carries its own account scope; the Account dropdown lists only what the key allows and auto-selects for single-account keys (no "Default Account ID").
  • Get AI Context gained an order option (oldest | newest); real SocialMate logo as the node/credential icon.
  • Removed the URL auto-heal beacon — only stable URLs are supported (127.0.0.1:3456 or a Named tunnel).
2.0.0
  • Per-account connections — each connection isolated to one account (or scoped set) with its own key and webhook.
  • New Message → Get AI Context operation — a role-mapped, token-windowed transcript + structured messages array for AI agents.
1.0.0
  • Initial release: the SocialMate action node (Message, Chat, Contact, Group, Media, Queue, Account, Sync, Webhook, API Key, System) and the SocialMate Trigger node (self-registering webhook, HMAC verification), with the SocialMate API credential.

Request a feature or get help

The node is shaped by what automation builders ask for. Two doors:

Prefer GitHub? Open an issue on the repository.

Free forever · no card Download free