Skip to content
Join the community

wapi is a self-hosted WhatsApp REST API

Link a number, get an API key and send or receive WhatsApp messages over HTTP.

wapi is a self-hosted REST API for WhatsApp. Link a number, get an API key, and send or receive messages over plain HTTP, including the group chats and personal threads that Meta's Cloud API does not reach. It is wire-compatible with WasenderAPI, so existing clients work by changing one base URL. Start at wapi.crafter.run.

From the wapi demo, recorded against a real session with the number masked.

Send anything, receive everything#

One send endpoint covers text, images, stickers, video and documents. Incoming messages reach your app as signed webhooks, with retries and backoff. Groups and contacts have their own endpoints.

wapi homepage with the headline WhatsApp over HTTP, on your own box, and a curl example for send-message
Sessions live on your server, and credentials stay in your database.

A sandbox with no phone#

A sandbox session is a fake number on a fake WhatsApp that pairs itself. A contact who does not exist can still fire a real webhook, so you can build against wapi before you point it at a real number.

Know the tradeoff#

wapi drives an unofficial client through Baileys, which is against WhatsApp's terms, so numbers used this way can be restricted or banned. The README says so up front, and per-session proxies and a paced sending mode reduce the risk without removing it.

Try it#

Download the CLI from the latest release, then:

wapi login
wapi sandbox create --use
wapi sessions connect
wapi send --to +51999888777 --text "hello"

The guide, the API reference and the OpenAPI document are linked from wapi.crafter.run.