Developer REST API Reference & SDKs

1

Overview & Base URL

API architecture, environments, and REST conventions

The OpenWA REST API enables programmatic interaction with WhatsApp. You can provision multi-device slots, generate dynamic QR codes, dispatch high-throughput transactional alerts, send rich media, and capture inbound replies via real-time webhooks.

// Production API Base Endpoint

https://wasetu.hostgeeks.in/api/v1

2

Authentication & Headers

Securing your API requests with Bearer Tokens

Every REST API request must authenticate by providing your Secret API Key in the Authorization header as a Bearer token, or alternatively via X-API-Key.

Authorization: Bearer wa_live_9a7e8b61c4d290fa

Content-Type: application/json

Accept: application/json

3

Anti-Ban Pacing & Rate Limits

Humanized typing delay engine and quota enforcement

To protect your connected numbers against WhatsApp spam filters, our socket gateway enforces automated human typing jitter (800ms – 2400ms delay between dispatches).

Burst Rate Limit Up to 30 requests/second per API token. Extra requests are held in priority FIFO queue.

Instance Pacing Outbound messages per instance are throttled with randomized jitter to simulate organic human typing.

GET /api/v1/instances

List All WhatsApp Instances

Slot Inventory

Returns an array of all WhatsApp instance slots provisioned under your account, along with their live socket connectivity state and paired phone numbers.

7-LANGUAGE CODE EXAMPLES Request

curl -X GET "https://wasetu.hostgeeks.in/api/v1/instances" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://wasetu.hostgeeks.in/api/v1/instances"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/instances", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/instances",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    req, _ := http.NewRequest("GET", "https://wasetu.hostgeeks.in/api/v1/instances", nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ListInstances {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/instances"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/instances")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "data": [
    {
      "instance_key": "inst_7fa289e",
      "name": "Support Line 1",
      "phone": "919876543210",
      "status": "connected",
      "created_at": "2026-08-30T10:15:00Z"
    }
  ]
}

POST /api/v1/instances

Create Instance Slot

Slot Allocation

Provisions a new WhatsApp multi-device slot in your workspace. Once created, you can immediately initiate QR pairing to link any mobile device.

Request Body Parameters

Field	Type	Status	Description
name	string	Required	Friendly label for the instance slot (e.g. `"Sales WhatsApp 01"`).

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/instances" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Customer Care Desk"
  }'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/instances"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "name": "Customer Care Desk"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/instances", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    name: "Customer Care Desk"
  })
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/instances",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'name' => 'Customer Care Desk'
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/instances"
    payload, _ := json.Marshal(map[string]string{
        "name": "Customer Care Desk",
    })

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class CreateInstance {
    public static void main(String[] args) throws Exception {
        String json = "{\"name\":\"Customer Care Desk\"}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/instances"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/instances")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "name" => "Customer Care Desk"
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (201 Created)

{
  "success": true,
  "message": "WhatsApp instance slot created successfully.",
  "data": {
    "instance_key": "inst_92bc401",
    "name": "Customer Care Desk",
    "status": "disconnected"
  }
}

POST /api/v1/instances/{instanceKey}/connect

Connect & Generate QR Code

Session Initializer

Spawns a multi-device WhatsApp Baileys socket session and generates a real-time QR code. Returns the QR code in Base64 Data URI format ready to display in your user interface.

7-LANGUAGE CODE EXAMPLES Request

curl -X POST "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/connect" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/connect"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.post(url, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/connect", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/connect",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/connect"
    req, _ := http.NewRequest("POST", url, nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ConnectInstance {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/connect"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Accept", "application/json")
            .POST(HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/connect")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message": "QR Code generated. Scan with WhatsApp to pair.",
  "data": {
    "instance_key": "inst_7fa289e",
    "status": "pairing",
    "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAA...",
    "expires_in": 45
  }
}

GET /api/v1/instances/{instanceKey}/status

Check Instance Connection Status

Socket Health

Polls the live socket state of an instance to verify whether WhatsApp web multi-device is currently active, pairing, or disconnected.

7-LANGUAGE CODE EXAMPLES Request

curl -X GET "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/status" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/status"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/status", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/status",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/status"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class CheckStatus {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/status"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/status")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "data": {
    "instance_key": "inst_7fa289e",
    "name": "Customer Care Desk",
    "phone": "919876543210",
    "status": "connected",
    "platform": "Baileys MD v6.5",
    "updated_at": "2026-08-30T17:45:00Z"
  }
}

GET /api/v1/instances/{instanceKey}/qr

Fetch Live QR Code

QR Polling

Retrieves the current active Base64 QR code image payload for a pairing session if it has not yet completed authentication.

7-LANGUAGE CODE EXAMPLES Request

curl -X GET "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/qr" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/qr"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.get(url, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/qr", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/qr",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/qr"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class GetQrCode {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/qr"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/qr")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "data": {
    "instance_key": "inst_7fa289e",
    "status": "pairing",
    "qr_code": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "expires_in": 30
  }
}

POST /api/v1/instances/{instanceKey}/logout

Logout & Unlink WhatsApp Device

Session Teardown

Terminates the WhatsApp multi-device session, closes socket handles, and clears persisted device keys from storage.

7-LANGUAGE CODE EXAMPLES Request

curl -X POST "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/logout" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/logout"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}

response = requests.post(url, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/logout", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/logout",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/logout"
    req, _ := http.NewRequest("POST", url, nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class LogoutInstance {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/logout"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Accept", "application/json")
            .POST(HttpRequest.BodyPublishers.noBody())
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/instances/inst_7fa289e/logout")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message": "WhatsApp instance unlinked and logged out successfully.",
  "data": {
    "instance_key": "inst_7fa289e",
    "status": "disconnected"
  }
}

POST /api/v1/messages/send

Send WhatsApp Text Message

Outbound Transactional

Dispatches a plain or markdown-formatted WhatsApp text message to any international mobile number.

Request Body Parameters

Field	Type	Status	Description
instance_key	string	Required	Unique identifier of your connected WhatsApp instance slot.
phone	string	Required	Recipient phone number with country code (e.g. `919876543210`). No leading + or dashes.
message	string	Required	Text message body (supports bold, _italic_, ~strike~, and emojis). Max 4096 chars.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/messages/send" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello! Your appointment is confirmed for *3:00 PM* today. - OpenWA"
  }'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/send"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello! Your appointment is confirmed for *3:00 PM* today. - OpenWA"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/send", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    instance_key: "inst_7fa289e",
    phone: "919876543210",
    message: "Hello! Your appointment is confirmed for *3:00 PM* today. - OpenWA"
  })
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/send",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'instance_key' => 'inst_7fa289e',
        'phone' => '919876543210',
        'message' => 'Hello! Your appointment is confirmed for *3:00 PM* today. - OpenWA'
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/send"
    payload, _ := json.Marshal(map[string]string{
        "instance_key": "inst_7fa289e",
        "phone":        "919876543210",
        "message":      "Hello! Your appointment is confirmed for *3:00 PM* today. - OpenWA",
    })

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SendWhatsApp {
    public static void main(String[] args) throws Exception {
        String json = """
            {
                "instance_key": "inst_7fa289e",
                "phone": "919876543210",
                "message": "Hello! Your appointment is confirmed for *3:00 PM* today. - %s"
            }
            """.formatted("OpenWA");

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/send"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/send")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "instance_key" => "inst_7fa289e",
  "phone" => "919876543210",
  "message" => "Hello! Your appointment is confirmed for *3:00 PM* today. - OpenWA"
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message": "WhatsApp message dispatched successfully.",
  "data": {
    "message_id": 1042,
    "wa_message_id": "3EB0F429A71",
    "phone": "919876543210",
    "status": "sent"
  }
}

POST /api/v1/messages/send-media

Send WhatsApp Document & Media

PDF / Image / Video / Audio

Dispatches a PDF invoice, document file, JPEG/PNG image, MP4 video, or audio file via a public HTTPS URL with an optional caption.

Request Body Parameters

Field	Type	Status	Description
instance_key	string	Required	Target instance key.
phone	string	Required	Recipient phone number with country code.
media_url	url	Required	Publicly accessible direct HTTPS URL to the media file.
caption	string	Optional	Text caption displayed under the media attachment.
media_type	string	Optional	Explicit media type: `"document"`, `"image"`, `"video"`, `"audio"`. Auto-detected if omitted.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/messages/send-media" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "media_url": "https://yourdomain.com/invoices/INV-1092.pdf",
    "caption": "Here is your monthly invoice receipt. Thank you!"
  }'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/send-media"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "media_url": "https://yourdomain.com/invoices/INV-1092.pdf",
    "caption": "Here is your monthly invoice receipt. Thank you!"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/send-media", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    instance_key: "inst_7fa289e",
    phone: "919876543210",
    media_url: "https://yourdomain.com/invoices/INV-1092.pdf",
    caption: "Here is your monthly invoice receipt. Thank you!"
  })
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/send-media",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'instance_key' => 'inst_7fa289e',
        'phone' => '919876543210',
        'media_url' => 'https://yourdomain.com/invoices/INV-1092.pdf',
        'caption' => 'Here is your monthly invoice receipt. Thank you!'
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/send-media"
    payload, _ := json.Marshal(map[string]string{
        "instance_key": "inst_7fa289e",
        "phone":        "919876543210",
        "media_url":    "https://yourdomain.com/invoices/INV-1092.pdf",
        "caption":      "Here is your monthly invoice receipt. Thank you!",
    })

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SendMedia {
    public static void main(String[] args) throws Exception {
        String json = """
            {
                "instance_key": "inst_7fa289e",
                "phone": "919876543210",
                "media_url": "https://yourdomain.com/invoices/INV-1092.pdf",
                "caption": "Here is your monthly invoice receipt. Thank you!"
            }
            """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/send-media"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/send-media")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "instance_key" => "inst_7fa289e",
  "phone" => "919876543210",
  "media_url" => "https://yourdomain.com/invoices/INV-1092.pdf",
  "caption" => "Here is your monthly invoice receipt. Thank you!"
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message": "Media message dispatched successfully.",
  "data": {
    "message_id": 1043,
    "wa_message_id": "3EB0D498C29",
    "phone": "919876543210",
    "media_type": "document",
    "status": "sent"
  }
}

POST /api/v1/messages/send-location

Send GPS Location Pin

Map Coordinates

Dispatches a native WhatsApp interactive Google Maps / OpenStreetMap GPS coordinate pin with place name and street address.

Request Body Parameters

Field	Type	Status	Description
instance_key	string	Required	Your WhatsApp instance key.
phone	string	Required	Recipient phone number with country code.
latitude	float	Required	Latitude coordinate (e.g. `28.613939`).
longitude	float	Required	Longitude coordinate (e.g. `77.209021`).
name	string	Optional	Venue, office, or store location name.
address	string	Optional	Street address details.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/messages/send-location" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "latitude": 28.613939,
    "longitude": 77.209021,
    "name": "Wasetu Corporate HQ",
    "address": "Connaught Place, New Delhi 110001, India"
}'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/send-location"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "latitude": 28.613939,
    "longitude": 77.209021,
    "name": "Wasetu Corporate HQ",
    "address": "Connaught Place, New Delhi 110001, India"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/send-location", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "latitude": 28.613939,
    "longitude": 77.209021,
    "name": "Wasetu Corporate HQ",
    "address": "Connaught Place, New Delhi 110001, India"
})
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/send-location",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "latitude": 28.613939,
    "longitude": 77.209021,
    "name": "Wasetu Corporate HQ",
    "address": "Connaught Place, New Delhi 110001, India"
}),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/send-location"
    var jsonStr = []byte(`{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "latitude": 28.613939,
    "longitude": 77.209021,
    "name": "Wasetu Corporate HQ",
    "address": "Connaught Place, New Delhi 110001, India"
}`)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonStr))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DispatchWhatsApp {
    public static void main(String[] args) throws Exception {
        String json = "{
    \"instance_key\": \"inst_7fa289e\",
    \"phone\": \"919876543210\",
    \"latitude\": 28.613939,
    \"longitude\": 77.209021,
    \"name\": \"Wasetu Corporate HQ\",
    \"address\": \"Connaught Place, New Delhi 110001, India\"
}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/send-location"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/send-location")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "latitude": 28.613939,
    "longitude": 77.209021,
    "name": "Wasetu Corporate HQ",
    "address": "Connaught Place, New Delhi 110001, India"
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

POST /api/v1/numbers/check

WhatsApp Number Registration Checker

onWhatsApp Verification

Checks whether one or multiple phone numbers are registered and active on WhatsApp before broadcasting campaigns.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/numbers/check" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "numbers": [
        "919876543210",
        "919999888777",
        "918888777666"
    ]
}'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/numbers/check"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "numbers": [
        "919876543210",
        "919999888777",
        "918888777666"
    ]
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/numbers/check", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "instance_key": "inst_7fa289e",
    "numbers": [
        "919876543210",
        "919999888777",
        "918888777666"
    ]
})
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/numbers/check",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode({
    "instance_key": "inst_7fa289e",
    "numbers": [
        "919876543210",
        "919999888777",
        "918888777666"
    ]
}),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/numbers/check"
    var jsonStr = []byte(`{
    "instance_key": "inst_7fa289e",
    "numbers": [
        "919876543210",
        "919999888777",
        "918888777666"
    ]
}`)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonStr))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DispatchWhatsApp {
    public static void main(String[] args) throws Exception {
        String json = "{
    \"instance_key\": \"inst_7fa289e\",
    \"numbers\": [
        \"919876543210\",
        \"919999888777\",
        \"918888777666\"
    ]
}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/numbers/check"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/numbers/check")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
    "instance_key": "inst_7fa289e",
    "numbers": [
        "919876543210",
        "919999888777",
        "918888777666"
    ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

{
  "success": true,
  "total_checked": 3,
  "registered_count": 2,
  "data": [
    { "phone": "919876543210", "exists": true, "jid": "919876543210@s.whatsapp.net" },
    { "phone": "919999888777", "exists": true, "jid": "919999888777@s.whatsapp.net" },
    { "phone": "918888777666", "exists": false, "jid": "918888777666@s.whatsapp.net" }
  ]
}

POST /api/v1/messages/send-buttons

Send Interactive Buttons

Quick Reply Actions

Dispatches 1-click interactive quick response buttons for instant customer feedback, confirmations, or routing.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/messages/send-buttons" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello Amit! Would you like to confirm your appointment for tomorrow?",
    "footer": "Powered by Wasetu Automated Care",
    "buttons": [
        {
            "id": "btn_confirm",
            "text": "\u2705 Confirm Booking"
        },
        {
            "id": "btn_reschedule",
            "text": "\ud83d\udcc5 Reschedule"
        },
        {
            "id": "btn_cancel",
            "text": "\u274c Cancel"
        }
    ]
}'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/send-buttons"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello Amit! Would you like to confirm your appointment for tomorrow?",
    "footer": "Powered by Wasetu Automated Care",
    "buttons": [
        {
            "id": "btn_confirm",
            "text": "\u2705 Confirm Booking"
        },
        {
            "id": "btn_reschedule",
            "text": "\ud83d\udcc5 Reschedule"
        },
        {
            "id": "btn_cancel",
            "text": "\u274c Cancel"
        }
    ]
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/send-buttons", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello Amit! Would you like to confirm your appointment for tomorrow?",
    "footer": "Powered by Wasetu Automated Care",
    "buttons": [
        {
            "id": "btn_confirm",
            "text": "\u2705 Confirm Booking"
        },
        {
            "id": "btn_reschedule",
            "text": "\ud83d\udcc5 Reschedule"
        },
        {
            "id": "btn_cancel",
            "text": "\u274c Cancel"
        }
    ]
})
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/send-buttons",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello Amit! Would you like to confirm your appointment for tomorrow?",
    "footer": "Powered by Wasetu Automated Care",
    "buttons": [
        {
            "id": "btn_confirm",
            "text": "\u2705 Confirm Booking"
        },
        {
            "id": "btn_reschedule",
            "text": "\ud83d\udcc5 Reschedule"
        },
        {
            "id": "btn_cancel",
            "text": "\u274c Cancel"
        }
    ]
}),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/send-buttons"
    var jsonStr = []byte(`{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello Amit! Would you like to confirm your appointment for tomorrow?",
    "footer": "Powered by Wasetu Automated Care",
    "buttons": [
        {
            "id": "btn_confirm",
            "text": "\u2705 Confirm Booking"
        },
        {
            "id": "btn_reschedule",
            "text": "\ud83d\udcc5 Reschedule"
        },
        {
            "id": "btn_cancel",
            "text": "\u274c Cancel"
        }
    ]
}`)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonStr))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DispatchWhatsApp {
    public static void main(String[] args) throws Exception {
        String json = "{
    \"instance_key\": \"inst_7fa289e\",
    \"phone\": \"919876543210\",
    \"message\": \"Hello Amit! Would you like to confirm your appointment for tomorrow?\",
    \"footer\": \"Powered by Wasetu Automated Care\",
    \"buttons\": [
        {
            \"id\": \"btn_confirm\",
            \"text\": \"\u2705 Confirm Booking\"
        },
        {
            \"id\": \"btn_reschedule\",
            \"text\": \"\ud83d\udcc5 Reschedule\"
        },
        {
            \"id\": \"btn_cancel\",
            \"text\": \"\u274c Cancel\"
        }
    ]
}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/send-buttons"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/send-buttons")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "message": "Hello Amit! Would you like to confirm your appointment for tomorrow?",
    "footer": "Powered by Wasetu Automated Care",
    "buttons": [
        {
            "id": "btn_confirm",
            "text": "\u2705 Confirm Booking"
        },
        {
            "id": "btn_reschedule",
            "text": "\ud83d\udcc5 Reschedule"
        },
        {
            "id": "btn_cancel",
            "text": "\u274c Cancel"
        }
    ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message_id": 105,
  "wa_message_id": "wamid.HBgMOTE5ODc2NTQzMjEw...",
  "phone": "919876543210",
  "status": "sent"
}

POST /api/v1/messages/send-lists

Send Interactive Lists & Catalogs

Multi-Section Menus

Dispatches multi-section interactive product menus, department lists, or service catalogs.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/messages/send-lists" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "title": "Wasetu Cloud Services",
    "message": "Please choose a department below to connect with an executive:",
    "button_text": "View Departments",
    "footer": "Available 24/7 Support",
    "sections": [
        {
            "title": "Customer Support",
            "rows": [
                {
                    "id": "sec_billing",
                    "title": "Billing & Invoices",
                    "description": "Payment issues and upgrades"
                },
                {
                    "id": "sec_tech",
                    "title": "Technical Support",
                    "description": "API integration help"
                }
            ]
        },
        {
            "title": "Sales & Growth",
            "rows": [
                {
                    "id": "sec_enterprise",
                    "title": "Enterprise Plans",
                    "description": "High volume custom plans"
                }
            ]
        }
    ]
}'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/send-lists"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "title": "Wasetu Cloud Services",
    "message": "Please choose a department below to connect with an executive:",
    "button_text": "View Departments",
    "footer": "Available 24/7 Support",
    "sections": [
        {
            "title": "Customer Support",
            "rows": [
                {
                    "id": "sec_billing",
                    "title": "Billing & Invoices",
                    "description": "Payment issues and upgrades"
                },
                {
                    "id": "sec_tech",
                    "title": "Technical Support",
                    "description": "API integration help"
                }
            ]
        },
        {
            "title": "Sales & Growth",
            "rows": [
                {
                    "id": "sec_enterprise",
                    "title": "Enterprise Plans",
                    "description": "High volume custom plans"
                }
            ]
        }
    ]
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/send-lists", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "title": "Wasetu Cloud Services",
    "message": "Please choose a department below to connect with an executive:",
    "button_text": "View Departments",
    "footer": "Available 24/7 Support",
    "sections": [
        {
            "title": "Customer Support",
            "rows": [
                {
                    "id": "sec_billing",
                    "title": "Billing & Invoices",
                    "description": "Payment issues and upgrades"
                },
                {
                    "id": "sec_tech",
                    "title": "Technical Support",
                    "description": "API integration help"
                }
            ]
        },
        {
            "title": "Sales & Growth",
            "rows": [
                {
                    "id": "sec_enterprise",
                    "title": "Enterprise Plans",
                    "description": "High volume custom plans"
                }
            ]
        }
    ]
})
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/send-lists",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "title": "Wasetu Cloud Services",
    "message": "Please choose a department below to connect with an executive:",
    "button_text": "View Departments",
    "footer": "Available 24/7 Support",
    "sections": [
        {
            "title": "Customer Support",
            "rows": [
                {
                    "id": "sec_billing",
                    "title": "Billing & Invoices",
                    "description": "Payment issues and upgrades"
                },
                {
                    "id": "sec_tech",
                    "title": "Technical Support",
                    "description": "API integration help"
                }
            ]
        },
        {
            "title": "Sales & Growth",
            "rows": [
                {
                    "id": "sec_enterprise",
                    "title": "Enterprise Plans",
                    "description": "High volume custom plans"
                }
            ]
        }
    ]
}),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/send-lists"
    var jsonStr = []byte(`{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "title": "Wasetu Cloud Services",
    "message": "Please choose a department below to connect with an executive:",
    "button_text": "View Departments",
    "footer": "Available 24/7 Support",
    "sections": [
        {
            "title": "Customer Support",
            "rows": [
                {
                    "id": "sec_billing",
                    "title": "Billing & Invoices",
                    "description": "Payment issues and upgrades"
                },
                {
                    "id": "sec_tech",
                    "title": "Technical Support",
                    "description": "API integration help"
                }
            ]
        },
        {
            "title": "Sales & Growth",
            "rows": [
                {
                    "id": "sec_enterprise",
                    "title": "Enterprise Plans",
                    "description": "High volume custom plans"
                }
            ]
        }
    ]
}`)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonStr))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DispatchWhatsApp {
    public static void main(String[] args) throws Exception {
        String json = "{
    \"instance_key\": \"inst_7fa289e\",
    \"phone\": \"919876543210\",
    \"title\": \"Wasetu Cloud Services\",
    \"message\": \"Please choose a department below to connect with an executive:\",
    \"button_text\": \"View Departments\",
    \"footer\": \"Available 24/7 Support\",
    \"sections\": [
        {
            \"title\": \"Customer Support\",
            \"rows\": [
                {
                    \"id\": \"sec_billing\",
                    \"title\": \"Billing & Invoices\",
                    \"description\": \"Payment issues and upgrades\"
                },
                {
                    \"id\": \"sec_tech\",
                    \"title\": \"Technical Support\",
                    \"description\": \"API integration help\"
                }
            ]
        },
        {
            \"title\": \"Sales & Growth\",
            \"rows\": [
                {
                    \"id\": \"sec_enterprise\",
                    \"title\": \"Enterprise Plans\",
                    \"description\": \"High volume custom plans\"
                }
            ]
        }
    ]
}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/send-lists"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/send-lists")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "title": "Wasetu Cloud Services",
    "message": "Please choose a department below to connect with an executive:",
    "button_text": "View Departments",
    "footer": "Available 24/7 Support",
    "sections": [
        {
            "title": "Customer Support",
            "rows": [
                {
                    "id": "sec_billing",
                    "title": "Billing & Invoices",
                    "description": "Payment issues and upgrades"
                },
                {
                    "id": "sec_tech",
                    "title": "Technical Support",
                    "description": "API integration help"
                }
            ]
        },
        {
            "title": "Sales & Growth",
            "rows": [
                {
                    "id": "sec_enterprise",
                    "title": "Enterprise Plans",
                    "description": "High volume custom plans"
                }
            ]
        }
    ]
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message_id": 106,
  "wa_message_id": "wamid.HBgMOTE5ODc2NTQzMjEw...",
  "phone": "919876543210",
  "status": "sent"
}

POST /api/v1/messages/send-contact

Send Contact Card (vCard)

Contact Sharing

Dispatches a native WhatsApp contact card / vCard 3.0 with full name, phone number, and organization name, enabling the recipient to save or message the contact in 1 click.

Request Body Parameters

Field	Type	Status	Description
instance_key	string	Required	Your connected WhatsApp instance key.
phone	string	Required	Recipient phone number with country code.
name	string	Required	Full display name of the contact.
contact_phone	string	Optional	Phone number of the contact card (defaults to recipient if omitted).
organization	string	Optional	Company or business affiliation name.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/messages/send-contact" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "name": "Alex Morgan",
    "contact_phone": "919876543210",
    "organization": "HostGeeks Cloud Services"
}'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/send-contact"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "name": "Alex Morgan",
    "contact_phone": "919876543210",
    "organization": "HostGeeks Cloud Services"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/send-contact", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "name": "Alex Morgan",
    "contact_phone": "919876543210",
    "organization": "HostGeeks Cloud Services"
})
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/send-contact",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "name": "Alex Morgan",
    "contact_phone": "919876543210",
    "organization": "HostGeeks Cloud Services"
}),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/send-contact"
    var jsonStr = []byte(`{
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "name": "Alex Morgan",
    "contact_phone": "919876543210",
    "organization": "HostGeeks Cloud Services"
}`)

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(jsonStr))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil { panic(err) }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class DispatchWhatsApp {
    public static void main(String[] args) throws Exception {
        String json = "{
    \"instance_key\": \"inst_7fa289e\",
    \"phone\": \"919876543210\",
    \"name\": \"Alex Morgan\",
    \"contact_phone\": \"919876543210\",
    \"organization\": \"HostGeeks Cloud Services\"
}";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/send-contact"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/send-contact")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
    "instance_key": "inst_7fa289e",
    "phone": "919876543210",
    "name": "Alex Morgan",
    "contact_phone": "919876543210",
    "organization": "HostGeeks Cloud Services"
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message_id": 107,
  "wa_message_id": "wamid.HBgMOTE5ODc2NTQzMjEw...",
  "phone": "919876543210",
  "status": "sent"
}

GET /api/v1/messages/history

Query Message History & Logs

Audit & Telemetry

Retrieves paginated historical outbound and inbound messages filtered by instance slot, recipient phone number, or date range.

Query Parameters

Field	Type	Status	Description
instance_key	string	Optional	Filter logs strictly for a specific instance slot.
phone	string	Optional	Filter messages sent to or received from a specific phone.
limit	integer	Optional	Results per page (default: 50, maximum: 200).
page	integer	Optional	Page offset number for pagination (default: 1).

7-LANGUAGE CODE EXAMPLES Request

curl -X GET "https://wasetu.hostgeeks.in/api/v1/messages/history?instance_key=inst_7fa289e&limit=20" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/history"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}
params = {
    "instance_key": "inst_7fa289e",
    "limit": 20
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/history?instance_key=inst_7fa289e&limit=20", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/history?instance_key=inst_7fa289e&limit=20",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "fmt"
    "net/http"
    "io/ioutil"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/history?instance_key=inst_7fa289e&limit=20"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := ioutil.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class QueryHistory {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/history?instance_key=inst_7fa289e&limit=20"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/history?instance_key=inst_7fa289e&limit=20")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "data": [
    {
      "id": 1042,
      "instance_key": "inst_7fa289e",
      "phone": "919876543210",
      "message": "Hello! Your appointment is confirmed for *3:00 PM* today.",
      "status": "delivered",
      "created_at": "2026-08-30T17:40:12Z"
    }
  ],
  "pagination": {
    "current_page": 1,
    "per_page": 20,
    "total": 148
  }
}

GET /api/v1/groups

List Participating WhatsApp Groups

Group Discovery & Metadata

Retrieves all active WhatsApp groups that the connected instance is a participating member of, including group IDs, subjects, participant counts, creation timestamps, and owner JIDs.

Query Parameters

Field	Type	Status	Description
instance_key	string	Required	Unique identifier of your connected WhatsApp instance slot.

7-LANGUAGE CODE EXAMPLES Request

curl -X GET "https://wasetu.hostgeeks.in/api/v1/groups?instance_key=inst_7fa289e" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json"

import requests

url = "https://wasetu.hostgeeks.in/api/v1/groups"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
}
params = {
    "instance_key": "inst_7fa289e"
}

response = requests.get(url, headers=headers, params=params)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/groups?instance_key=inst_7fa289e", {
  method: "GET",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Accept": "application/json"
  }
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/groups?instance_key=inst_7fa289e",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Accept: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "fmt"
    "io"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/groups?instance_key=inst_7fa289e"
    req, _ := http.NewRequest("GET", url, nil)
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Accept", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    body, _ := io.ReadAll(resp.Body)
    fmt.Println(string(body))
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class ListWhatsAppGroups {
    public static void main(String[] args) throws Exception {
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/groups?instance_key=inst_7fa289e"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Accept", "application/json")
            .GET()
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/groups?instance_key=inst_7fa289e")
request = Net::HTTP::Get.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Accept"] = "application/json"

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "total": 2,
  "groups": [
    {
      "id": "120363421634618099@g.us",
      "subject": "Executive Management & Operations",
      "participantsCount": 24,
      "creation": 1788078000,
      "owner": "919958240463@s.whatsapp.net",
      "desc": "Official coordination channel for operations and field dispatch."
    },
    {
      "id": "120363389145672101@g.us",
      "subject": "DevOps & Infrastructure Alerts",
      "participantsCount": 12,
      "creation": 1787954000,
      "owner": "919876543210@s.whatsapp.net",
      "desc": "Automated incident notices and build monitoring."
    }
  ]
}

POST /api/v1/messages/send-group

Send WhatsApp Group Message

Broadcast & Group Announcements

Dispatches announcements, status updates, notifications, or document attachments directly to any WhatsApp Group. Supports full WhatsApp markdown formatting (*bold*, _italic_, ~strikethrough~, bullet lists, numbered lists, and quotes).

Request Body Parameters

Field	Type	Status	Description
instance_key	string	Required	Unique identifier of your connected WhatsApp instance slot.
group_id	string	Required	Target WhatsApp Group JID ending with `@g.us` (e.g. `120363421634618099@g.us`) or 18-digit group number.
message	string	Required	Message text content. Full WhatsApp markdown is enabled. Max 4096 characters.
media_url	string	Optional	Publicly accessible direct HTTPS URL to an image, document, audio, or video attachment.

7-LANGUAGE CODE EXAMPLES JSON Payload

curl -X POST "https://wasetu.hostgeeks.in/api/v1/messages/send-group" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "instance_key": "inst_7fa289e",
    "group_id": "120363421634618099@g.us",
    "message": "*Important Announcement:* \nScheduled maintenance has completed successfully! 🚀",
    "media_url": "https://example.com/release-notes.pdf"
  }'

import requests

url = "https://wasetu.hostgeeks.in/api/v1/messages/send-group"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
}
payload = {
    "instance_key": "inst_7fa289e",
    "group_id": "120363421634618099@g.us",
    "message": "*Important Announcement:* \nScheduled maintenance has completed successfully! 🚀",
    "media_url": "https://example.com/release-notes.pdf"
}

response = requests.post(url, json=payload, headers=headers)
print(response.json())

const response = await fetch("https://wasetu.hostgeeks.in/api/v1/messages/send-group", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    instance_key: "inst_7fa289e",
    group_id: "120363421634618099@g.us",
    message: "*Important Announcement:* \nScheduled maintenance has completed successfully! 🚀",
    media_url: "https://example.com/release-notes.pdf"
  })
});
const data = await response.json();
console.log(data);

<?php
$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://wasetu.hostgeeks.in/api/v1/messages/send-group",
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_CUSTOMREQUEST => 'POST',
    CURLOPT_POSTFIELDS => json_encode([
        'instance_key' => 'inst_7fa289e',
        'group_id' => '120363421634618099@g.us',
        'message' => "*Important Announcement:* \nScheduled maintenance has completed successfully! 🚀",
        'media_url' => 'https://example.com/release-notes.pdf',
    ]),
    CURLOPT_HTTPHEADER => [
        'Authorization: Bearer YOUR_API_KEY',
        'Content-Type: application/json'
    ],
]);
$response = curl_exec($curl);
curl_close($curl);
echo $response;

package main

import (
    "bytes"
    "encoding/json"
    "fmt"
    "net/http"
)

func main() {
    url := "https://wasetu.hostgeeks.in/api/v1/messages/send-group"
    payload, _ := json.Marshal(map[string]string{
        "instance_key": "inst_7fa289e",
        "group_id":     "120363421634618099@g.us",
        "message":      "*Important Announcement:* \nScheduled maintenance has completed successfully! 🚀",
        "media_url":    "https://example.com/release-notes.pdf",
    })

    req, _ := http.NewRequest("POST", url, bytes.NewBuffer(payload))
    req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
    req.Header.Set("Content-Type", "application/json")

    client := &http.Client{}
    resp, err := client.Do(req)
    if err != nil {
        panic(err)
    }
    defer resp.Body.Close()
    fmt.Println("Status:", resp.Status)
}

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;

public class SendWhatsAppGroup {
    public static void main(String[] args) throws Exception {
        String json = """
            {
                "instance_key": "inst_7fa289e",
                "group_id": "120363421634618099@g.us",
                "message": "*Important Announcement:* \\nScheduled maintenance has completed successfully! 🚀",
                "media_url": "https://example.com/release-notes.pdf"
            }
            """;

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
            .uri(URI.create("https://wasetu.hostgeeks.in/api/v1/messages/send-group"))
            .header("Authorization", "Bearer YOUR_API_KEY")
            .header("Content-Type", "application/json")
            .POST(HttpRequest.BodyPublishers.ofString(json))
            .build();

        HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println(response.body());
    }
}

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://wasetu.hostgeeks.in/api/v1/messages/send-group")
request = Net::HTTP::Post.new(uri)
request["Authorization"] = "Bearer YOUR_API_KEY"
request["Content-Type"] = "application/json"
request.body = JSON.dump({
  "instance_key" => "inst_7fa289e",
  "group_id" => "120363421634618099@g.us",
  "message" => "*Important Announcement:* \nScheduled maintenance has completed successfully! 🚀",
  "media_url" => "https://example.com/release-notes.pdf"
})

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: uri.scheme == 'https') do |http|
  http.request(request)
end

puts response.body

Sample Success Response (200 OK)

{
  "success": true,
  "message": "Group message dispatched successfully to 120363421634618099@g.us",
  "data": {
    "id": 1089,
    "instance_key": "inst_7fa289e",
    "group_id": "120363421634618099@g.us",
    "message": "*Important Announcement:* \nScheduled maintenance has completed successfully! 🚀",
    "media_url": "https://example.com/release-notes.pdf",
    "status": "sent",
    "created_at": "2026-09-04T00:10:00Z"
  }
}

Real-Time Inbound Webhooks

Receive customer replies and real-time delivery acknowledgments

Configure your webhook endpoint URL inside your Client Portal. Whenever an inbound message arrives or an outbound message transitions status (sent → delivered → read), our gateway dispatches an HTTP POST JSON event directly to your server.

EVENT Inbound Message Event (`messages.upsert`)

{
  "event": "messages.upsert",
  "instance_key": "inst_7fa289e",
  "phone": "919876543210",
  "sender_name": "Sarah Connor",
  "message_body": "Hi! I would like to book a demo coaching session for tomorrow.",
  "message_type": "text",
  "timestamp": 1788092058
}

EVENT Delivery Status Receipt (`messages.update`)

{
  "event": "messages.update",
  "instance_key": "inst_7fa289e",
  "wa_message_id": "3EB0F429A71",
  "phone": "919876543210",
  "status": "read",
  "timestamp": 1788092062
}

HTTP Error Codes & Resolutions

Standard status codes returned by the API

Code	Meaning	Resolution Guide
200 OK	Success	Request processed and WhatsApp message sent or session updated.
400 Bad Request	Instance Disconnected	Device is not connected. Scan QR in portal or use `/instances/{key}/connect`.
401 Unauthorized	Invalid API Token	Ensure your Bearer token is passed correctly in the `Authorization` header.
403 Forbidden	Feature Locked	Your subscription plan does not include REST API access. Upgrade your plan.
422 Unprocessable	Validation Error	One or more required fields are missing or invalid (e.g. invalid phone number format).
429 Rate Limit	Quota Exceeded	Daily or monthly message limit exhausted, or burst rate exceeded. Upgrade to higher tier.
500 Server Error	Internal Failure	WhatsApp socket engine failure or internal exception. Verify gateway daemon is running.

Developer API Reference & Webhooks

Overview & Base URL

Authentication & Headers

Anti-Ban Pacing & Rate Limits

List All WhatsApp Instances

Sample Success Response (200 OK)

Create Instance Slot

Request Body Parameters

Sample Success Response (201 Created)

Connect & Generate QR Code

Sample Success Response (200 OK)

Check Instance Connection Status

Sample Success Response (200 OK)

Fetch Live QR Code

Sample Success Response (200 OK)

Logout & Unlink WhatsApp Device

Sample Success Response (200 OK)

Send WhatsApp Text Message

Request Body Parameters

Sample Success Response (200 OK)

Send WhatsApp Document & Media

Request Body Parameters

Sample Success Response (200 OK)

Send GPS Location Pin

Request Body Parameters

WhatsApp Number Registration Checker

Send Interactive Buttons

Sample Success Response (200 OK)

Send Interactive Lists & Catalogs

Sample Success Response (200 OK)

Send Contact Card (vCard)

Request Body Parameters

Sample Success Response (200 OK)

Query Message History & Logs

Query Parameters

Sample Success Response (200 OK)

List Participating WhatsApp Groups

Query Parameters

Sample Success Response (200 OK)

Send WhatsApp Group Message

Request Body Parameters

Sample Success Response (200 OK)

Real-Time Inbound Webhooks

EVENT Inbound Message Event (messages.upsert)

EVENT Delivery Status Receipt (messages.update)

HTTP Error Codes & Resolutions

Cookie & Privacy Choices

Cookie Preferences

EVENT Inbound Message Event (`messages.upsert`)

EVENT Delivery Status Receipt (`messages.update`)