WaConnect API Documentation

Welcome to the WaConnect API. This documentation provides everything you need to integrate WhatsApp messaging into your application using our platform.

ⓘ

Looking for the interactive API explorer? Visit the Swagger UI to try endpoints directly in your browser.

Overview

WaConnect is a multi-tenant WhatsApp Business API platform built on top of the Meta Cloud API. It provides a simplified REST API for sending and receiving WhatsApp messages, with built-in message tracking, inbox management, and webhook forwarding.

Supported Message Types

Type	Endpoint	Description
Text	`POST /api/messages/text`	Plain text with optional URL preview
Image	`POST /api/messages/image`	JPEG/PNG image with optional caption
Video	`POST /api/messages/video`	MP4 video with optional caption
Audio	`POST /api/messages/audio`	MP3/OGG audio file
Document	`POST /api/messages/document`	PDF, DOCX, or other document
Sticker	`POST /api/messages/sticker`	WebP sticker image
Location	`POST /api/messages/location`	GPS coordinates with name/address
Reply Buttons	`POST /api/messages/reply-buttons`	Up to 3 quick-reply buttons
List	`POST /api/messages/list`	Menu with sections and rows
Auth Template	`POST /api/messages/auth-template`	OTP authentication template

Quick Start

Get Your API Key

Your WaConnect administrator will provide you with an API Key (starting with wba_) and your Dashboard credentials. Keep the API key secure and never expose it in client-side code.

Send Your First Message

Use the API key in the X-API-Key header to send a text message:

// HTTP Request
POST /api/messages/text HTTP/1.1
Host: app.waconnect.me
X-API-Key: wba_YOUR_API_KEY_HERE
Content-Type: application/json

{
  "to": "15551234567",
  "body": "Hello from WaConnect!"
}HTTP

Check the Response

A successful response returns the WhatsApp message ID:

{
  "success": true,
  "messageId": "wamid.HBgLMTU1NTEyMzQ1NjcVAgASGCA0",
  "to": "15551234567",
  "type": "text"
}JSON

Set Up Webhooks

To receive incoming messages and delivery receipts, ask your administrator to configure your Callback URL. See the Webhooks guide for details.

Base URL

All API endpoints are relative to:

https://app.waconnect.me/apiBase URL

Need Help?

Use the Chat Simulator in your Dashboard to test sending and receiving messages interactively before writing code. You can also explore all endpoints via the Swagger UI.