Skip to main content

GOWA WhatsApp API

A powerful WhatsApp Web API with multi-device support, built in Go for efficient memory use. Send messages, manage groups, and integrate with AI agents through REST or MCP protocols.

Get StartedAPI Reference

Quick start

Get up and running with GOWA in minutes

1

Install and run the server

Choose your preferred installation method:
docker run -d -p 3000:3000 \
  --name whatsapp \
  --restart always \
  -v whatsapp:/app/storages \
  aldinokemal2104/go-whatsapp-web-multidevice rest
The server will start on http://localhost:3000
2

Connect your WhatsApp account

Open your browser to http://localhost:3000 and scan the QR code with your WhatsApp mobile app:
  1. Open WhatsApp on your phone
  2. Tap Menu (⋮) or Settings and select Linked Devices
  3. Tap Link a Device
  4. Scan the QR code displayed in your browser
You can also use pairing code authentication instead of QR code by visiting /app/login-with-code?phone=628123456789
3

Send your first message

Once connected, send a test message using the REST API:
cURL
curl -X POST http://localhost:3000/send/message \
  -H "Content-Type: application/json" \
  -d '{
    "phone": "[email protected]",
    "message": "Hello from GOWA!"
  }'

{
  "code": 200,
  "message": "Success",
  "data": {
    "message_id": "3EB0C0A6B4B8F8D7E9F1",
    "status": "success"
  }
}
4

Explore advanced features

Now that you’re connected, explore more capabilities:

Key features

Everything you need to build WhatsApp automation

Multi-device support

Connect and manage multiple WhatsApp accounts simultaneously in a single server instance

Rich messaging

Send text, images, audio, video, stickers, contacts, locations, and polls

Webhooks

Receive real-time events with HMAC security and flexible event filtering

Group management

Create groups, manage participants, and control permissions programmatically

MCP integration

Connect AI agents using Model Context Protocol for intelligent automation

Chatwoot CRM

Integrate with Chatwoot for professional customer support workflows

Explore by topic

Jump to the documentation you need

API Reference

Complete REST API documentation with request/response examples for all endpoints

Browse API docs

Sending Messages

Learn how to send text, media, and rich messages including mentions and ghost mentions

View guide

Webhook Integration

Receive real-time events with filtering, HMAC verification, and payload examples

Setup webhooks

Deployment

Deploy with Docker, Docker Compose, or as a standalone binary with configuration options

Deploy now

Ready to get started?

Follow our quickstart guide to set up your WhatsApp API server and send your first message in under 5 minutes.

View quickstart guide