List contact groups
curl --request GET \
--url https://api.inbox.adraa.ai/api/v1/contact-groups \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.inbox.adraa.ai/api/v1/contact-groups"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.inbox.adraa.ai/api/v1/contact-groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.inbox.adraa.ai/api/v1/contact-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.inbox.adraa.ai/api/v1/contact-groups"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.inbox.adraa.ai/api/v1/contact-groups")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.inbox.adraa.ai/api/v1/contact-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"groups": [
{
"id": "cmbxh1a2b0004ph01q8r9s0t1",
"name": "VIP customers",
"description": "High-value accounts",
"memberCount": 42,
"whatsappCount": 37,
"members": [
{
"id": "cmbxgy7kq0002ph01u2v3w4x5",
"name": "Sara",
"email": null,
"phone": "+966500000000",
"hasWhatsapp": true,
"channels": [
"whatsapp"
]
}
],
"createdAt": "2026-06-14T09:00:00.000Z",
"updatedAt": "2026-06-14T09:00:00.000Z"
}
]
}{
"error": {
"code": "INVALID_API_TOKEN",
"message": "Invalid or revoked API token"
}
}Broadcast
List contact groups
Lists the workspace’s broadcast contact groups, each with its members and how many of them can be reached on WhatsApp. Manage groups and their members in the console’s Broadcast page.
GET
/
api
/
v1
/
contact-groups
List contact groups
curl --request GET \
--url https://api.inbox.adraa.ai/api/v1/contact-groups \
--header 'Authorization: Bearer <token>'import requests
url = "https://api.inbox.adraa.ai/api/v1/contact-groups"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.inbox.adraa.ai/api/v1/contact-groups', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.inbox.adraa.ai/api/v1/contact-groups",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.inbox.adraa.ai/api/v1/contact-groups"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.inbox.adraa.ai/api/v1/contact-groups")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.inbox.adraa.ai/api/v1/contact-groups")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"groups": [
{
"id": "cmbxh1a2b0004ph01q8r9s0t1",
"name": "VIP customers",
"description": "High-value accounts",
"memberCount": 42,
"whatsappCount": 37,
"members": [
{
"id": "cmbxgy7kq0002ph01u2v3w4x5",
"name": "Sara",
"email": null,
"phone": "+966500000000",
"hasWhatsapp": true,
"channels": [
"whatsapp"
]
}
],
"createdAt": "2026-06-14T09:00:00.000Z",
"updatedAt": "2026-06-14T09:00:00.000Z"
}
]
}{
"error": {
"code": "INVALID_API_TOKEN",
"message": "Invalid or revoked API token"
}
}⌘I