API REFERENCE

WaDevZone REST API

Integrate WhatsApp into your application with a simple, fast and secure REST API. Send messages, media, locations, contacts and manage sessions using powerful endpoints.

Get Started Documentation

Getting Started

All endpoints are RESTful and return JSON responses. 

https://api.wadevzone.com/api/v1

Authentication

Include your API Token inside every request. 

Authorization: Bearer YOUR_API_TOKEN

Base URL

https://api.wadevzone.com/api/v1
POST

/messages/send

Send a WhatsApp text message.

Parameter Type Required
session string Yes
phone string Yes
message string Yes

Example Request

{
    "session":"default",
    "phone":"201001234567",
    "message":"Hello World"
}

Example Response

{
    "status":true,
    "message":"Message Sent Successfully",
    "id":"MSG_152345"
}
GET

/sessions

Retrieve all active WhatsApp sessions. 

{
    "status":true,
    "data":[
        {
            "session":"default",
            "status":"connected"
        },
        {
            "session":"marketing",
            "status":"disconnected"
        }
    ]
}
POST

/sessions/create

Create new WhatsApp Session.

session string Required 
{
    "session":"shop"
}
GET

/groups

Get all WhatsApp Groups. 

{
 "status":true,
 "groups":[
   {
      "id":"120363...",
      "name":"Support"
   }
 ]
}
GET

/contacts

Retrieve all contacts. 

{
 "status":true,
 "contacts":[
    {
      "name":"Mohammed",
      "phone":"201001234567"
    }
 ]
}
POST

/messages/media

Send Image, PDF, Video or Audio.

Name Type Required
phone string Yes
media file/url Yes
caption string No 
{
 "phone":"201001234567",
 "media":"https://example.com/image.jpg",
 "caption":"Hello"
}
POST

/webhooks

Receive WhatsApp Events in real time. 

{
 "event":"message.received",
 "session":"default",
 "from":"201001234567",
 "body":"Hello"
}

Error Codes

Code Description
200 Success
400 Bad Request
401 Unauthorized
404 Endpoint Not Found
422 Validation Error
500 Internal Server Error