Introduction
Cloud-hosted WhatsApp API with managed webhooks
WAHooks is a cloud-hosted WhatsApp API that lets you send messages, receive real-time webhooks, and manage WhatsApp connections — without running any infrastructure yourself.
Quick example
import { WAHooks } from '@wahooks/sdk';
const client = new WAHooks({ apiKey: 'wh_...' });
// Send a message
await client.sendMessage(connectionId, '1234567890@s.whatsapp.net', 'Hello!');
// Set up a webhook for incoming messages
await client.createWebhook(connectionId, 'https://your-server.com/webhook');from wahooks import WAHooks
client = WAHooks(api_key="wh_...")
# Send a message
client.send_message(connection_id, chat_id="1234567890@s.whatsapp.net", text="Hello!")
# Set up a webhook for incoming messages
client.create_webhook(connection_id, url="https://your-server.com/webhook")# Send a message
curl -X POST https://api.wahooks.com/api/connections/CONNECTION_ID/send \
-H "Authorization: Bearer wh_..." \
-H "Content-Type: application/json" \
-d '{"chatId": "1234567890@s.whatsapp.net", "text": "Hello!"}'
# Create a webhook
curl -X POST https://api.wahooks.com/api/connections/CONNECTION_ID/webhooks \
-H "Authorization: Bearer wh_..." \
-H "Content-Type: application/json" \
-d '{"url": "https://your-server.com/webhook", "events": ["*"]}'How it works
Connect a WhatsApp number
Create a connection and scan a QR code with WhatsApp to link your account. WAHooks provisions a dedicated cloud session that stays connected 24/7.
Configure webhooks
Point webhook URLs at your server. When messages arrive, WAHooks delivers them as signed HTTP POST requests with automatic retries.
Build your app
Use the TypeScript or Python SDK to send messages, fetch chats, and manage connections. Or call the REST API directly.
Why WAHooks
Zero infrastructure
WAHooks runs WAHA sessions in Kubernetes with automatic health monitoring, failover, and scaling. You just call the API.
Reliable webhooks
HMAC-SHA256 signed deliveries with exponential backoff (5 retries), delivery logs, and a dead-letter queue for failed events.
Official SDKs
TypeScript and Python SDKs with full API coverage. Install with npm install @wahooks/sdk or pip install wahooks.
CLI & API tokens
Manage everything from the terminal. Browser-based login, auto-refreshing tokens, and long-lived API keys for your apps.
MCP Server
Use WAHooks from Claude, ChatGPT, Cursor, and other AI assistants via the Model Context Protocol.
Install
npm install @wahooks/sdkpip install wahookscurl -fsSL https://wahooks.com/install | bashbrew install dhruvyad/tap/wahooksNext steps
Quick Start
Connect a WhatsApp number, set up webhooks, and send your first message in 5 minutes.
API Reference
Explore all REST endpoints with request/response examples.
TypeScript SDK
Full SDK reference with types, error handling, and examples.
Python SDK
Full SDK reference with context manager support and error handling.