Use cases

WhatsApp community API for developers

HelloHop gives developers a REST API to create WhatsApp communities and manage their linked groups. Use your linked channel to create a community, add a subgroup, link or unlink an existing group, read participants and fetch an invite link. Requests use your channel token, and the responses identify groups by JID.

Build around communities and subgroups

• Create a parent community and subgroups for separate conversations.
• Link an existing group to a community or unlink it.
• List linked subgroups and read participants across the community.
• Fetch the community invite link.

Create a community

API=https://api.hellohop.app/v1
BASE="$API/sessions/$CHANNEL_ID"
AUTH="Authorization: Bearer $CHANNEL_TOKEN"

curl -s -X POST "$BASE/communities" \
  -H "$AUTH" \
  -H "Content-Type: application/json" \
  -d '{"subject":"My community"}'

const API = 'https://api.hellohop.app/v1';
const { CHANNEL_ID, CHANNEL_TOKEN } = process.env;
const BASE = `${API}/sessions/${CHANNEL_ID}`;
const headers = {
  Authorization: `Bearer ${CHANNEL_TOKEN}`,
  'Content-Type': 'application/json',
};

async function call(method, path, body) {
  const res = await fetch(`${BASE}${path}`, {
    method,
    headers,
    body: body === undefined ? undefined : JSON.stringify(body),
  });
  const data = await res.json();
  if (!res.ok) throw new Error(`${res.status} ${data.code}: ${data.error}`);
  return data;
}

const community = await call('POST', `/communities`, {"subject":"My community"});
console.log(community);

Community routes

Limits and caveats

Create costs one group add. Linking an existing group costs one add. A subgroup costs one for creation, one for its link and one per supplied participant. These counts apply to sandbox allowances and to optional warming, when it is enabled. A create or link can fail; do not assume that a timed-out write did nothing.

A successful hidden subgroup create does not prove its phone-visible hidden status. WhatsApp exposes no readable signal for that guarantee. If hidden creation returns verification_failed, the subgroup already exists: use its group_jid to repair the link instead of creating it again.

HelloHop is an independent WhatsApp API for developers: send and receive messages, automate groups and communities, and get signed webhooks with a free sandbox. Not affiliated with WhatsApp or Meta. You link your own number.