Send your first message
Create a scoped key in the dashboard, call GET /v1/me to prove it works,
then send. The quickstart takes about five
minutes end to end.
K-Message API
Send WhatsApp messages from your own system. Create a key, make one call, and you are live.
Know what happened
Subscribe to message.delivered, message.read and message.failed and
your own system learns the outcome of every send, with Meta’s reason when
one is refused.
Retry safely
Every send accepts an Idempotency-Key. A retry after a timeout replays
the original result instead of delivering a second message to a real
customer.
Grant only what is needed
Keys carry explicit scopes. A key that sends order confirmations cannot delete a contact, and revoking it does not touch anything else.
What you can build
Section titled “What you can build” Order and delivery notifications Your store or ERP sends an approved template the moment an order ships, and records the delivery receipt.
A shared inbox in your own product Read conversations and history, send replies, and stream new messages in through webhooks.
A contact list that stays in sync Pull everything changed since your last run with updated_since, instead of the whole book every night.
Bulk sends triggered from your system Build a campaign, upload recipients in batches, start it, and poll the counts.
Before you start
Section titled “Before you start”You need a K-Message account with a WhatsApp number connected, and an API key. Both live in the dashboard under Settings → API Keys. Nothing here requires talking to us first.
If your number is not connected yet, do that before reading further: every endpoint below sends from, or reads messages belonging to, a specific WhatsApp number.