API documentation

Introduction

Send approved WhatsApp template messages from your own systems with one HTTPS call.

The wabapi API lets your ticketing, CRM, booking or billing system send a WhatsApp template message to a customer the moment something happens — a confirmation, a reminder, a one-time code — from the WhatsApp Business number you connected in the app.

It is deliberately small. There is one endpoint to send a template, one to check what happened to it, and one to upload a file for a document, image or video header. Templates themselves are created and approved in the app, exactly as for campaigns; the API only sends ones Meta has approved.

Base URL

https://wabapi.com/api/v1

At a glance

POSThttps://wabapi.com/api/v1/messages/template

GEThttps://wabapi.com/api/v1/messages/{id}

POSThttps://wabapi.com/api/v1/media

Every request and response is JSON, except that an upload sends its file as multipart/form-data. Times are ISO 8601 in UTC. Phone numbers are Indian mobiles in international format without the plus, for example 917021948630.

Pricing

An API send costs the same credits as the same template sent from the app: 1 credit for a utility or authentication template, 4 for a marketing template. Credits are debited before the send and refunded automatically if our messaging platform refuses it or WhatsApp reports it undeliverable. There is no separate API fee.

Before your first call

  • A connected WhatsApp Business number — connect it under Settings → WhatsApp before your first send. Without one, a send answers 409 number_not_connected.
  • At least one approved template — create it under Templates and wait for Meta's approval; the API only sends templates that are live. An unknown or unapproved name answers 404 template_not_found or 409 template_not_approved.
  • Credits in your account — top up under Credits. Until your first payment you can send free test messages to your own verified number (the one you signed in with); any other number answers 402 insufficient_credits and nothing is sent.