Skip to content
SocialMate
Knowledge base

Developer API & automation

A real local REST API, webhooks, OpenAPI, and a built-in tunnel.

← All categories

Getting started with the local API

Send your first message over the local HTTP API with an x-api-key in under five minutes.

Read →

API authentication & keys

Create, label, copy, and revoke API keys — each hashed, scoped, and rate-limited.

Read →

The OpenAPI spec & live docs

Every endpoint, request, and response — documented live on your own machine.

Read →

Setting up webhooks

Push real-time events to your automation — with HMAC signatures, retries, and a test button.

Read →

Webhook events reference (35)

The full catalogue of events you can subscribe to — messaging, accounts, media, queue, tunnel, and license.

Read →

Reactions, replies, polls, locations & contact cards

Quote a message, react with an emoji, show a typing indicator, mark a chat read, and send polls, location pins or contact cards.

Read →

Agent Memory: give your AI a persistent memory

Let your own AI agent save a contact's name and cache media descriptions, so it never re-asks or re-analyzes. Pro.

Read →

Cloudflare Tunnel: Quick vs Named

Expose your local API to the internet without opening ports — a rotating URL on Free, a stable URL on Pro.

Read →

Automate WhatsApp with the native n8n node

Install the SocialMate community node and automate WhatsApp in n8n — including as an AI Agent tool, and over MCP with Claude Desktop or Cur…

Read →

Connect n8n, Make & Zapier

Use the native n8n node, or wire any platform in with an HTTP node out and a webhook in.

Read →

Send from your own code (curl / Node / Python)

Copy-paste snippets to send a message from the shell, Node, or Python in under a minute.

Read →

Can’t find an answer? Open a ticket or email [email protected]. Live service status: status page.

Free forever · no card Download free