Groups

Endpoints for managing WhatsApp groups

Get Active Groups

get

Retrieve list of active groups for a business phone number with pagination support.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Query parameters

limitintegerOptional

Number of groups to fetch (1-1024, default 25)

afterstringOptional

Cursor for pagination

beforestringOptional

Cursor for pagination

Responses

200

Groups retrieved successfully

application/json

objectOptional

401

Unauthorized

application/json

500

Internal server error

application/json

get

/groups

HTTPcURLJavaScriptPython

GET /groups HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{}

Create Group

post

Create a new WhatsApp group with specified subject, description, and join approval mode.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Body

application/json

stringOptional

Responses

200

Group created successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

500

Internal server error

application/json

post

/groups

HTTPcURLJavaScriptPython

POST /groups HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"

{}

Get Group Information

get

Retrieve detailed metadata about a specific group including participants and settings.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Query parameters

fieldsstringOptional

Comma-separated list of fields to return

Responses

200

Group information retrieved successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

get

/groups/{group_id}

HTTPcURLJavaScriptPython

GET /groups/{group_id} HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{}

Update Group Settings

post

Update group subject, description, and profile picture.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Body

multipart/form-data

stringOptional

Responses

200

Group updated successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

post

/groups/{group_id}

HTTPcURLJavaScriptPython

POST /groups/{group_id} HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: multipart/form-data
Accept: */*
Content-Length: 6

"text"

{}

Delete Group

delete

Delete the group and remove all participants permanently.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Responses

200

Group deleted successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

delete

/groups/{group_id}

HTTPcURLJavaScriptPython

DELETE /groups/{group_id} HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{}

Get Group Invite Link

get

Retrieve the current invite link for a group that allows users to join.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Responses

200

Invite link retrieved successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

get

/groups/{group_id}/invite_link

HTTPcURLJavaScriptPython

GET /groups/{group_id}/invite_link HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{}

Reset Group Invite Link

post

Reset the invite link for a group, invalidating previous links.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Body

application/json

objectOptional

Responses

200

Invite link reset successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

post

/groups/{group_id}/invite_link

HTTPcURLJavaScriptPython

POST /groups/{group_id}/invite_link HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 2

{}

{}

Get Join Requests

get

Retrieve list of pending join requests for a group requiring approval.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Responses

200

Join requests retrieved successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

get

/groups/{group_id}/join_requests

HTTPcURLJavaScriptPython

GET /groups/{group_id}/join_requests HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Accept: */*

{}

Approve Join Requests

post

Approve one or more pending join requests for a group.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Bodystring[]

application/json

string[]Optional

Responses

200

Join requests approved successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

post

/groups/{group_id}/join_requests

HTTPcURLJavaScriptPython

POST /groups/{group_id}/join_requests HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 8

[
  "text"
]

{}

Reject Join Requests

delete

Reject one or more pending join requests for a group.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Bodystring[]

application/json

string[]Optional

Responses

200

Join requests rejected successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

delete

/groups/{group_id}/join_requests

HTTPcURLJavaScriptPython

DELETE /groups/{group_id}/join_requests HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 8

[
  "text"
]

{}

Remove Group Participants

delete

Remove one or more participants from a group.

Authorizations

D360-API-KEY

D360-API-KEYstringRequired

API Key for Messaging API authentication. Send your API key in the D360-API-KEY header.

Path parameters

group_idstringRequired

Group ID

Body

application/json

stringOptional

Responses

200

Participants removed successfully

application/json

objectOptional

400

Bad request

application/json

401

Unauthorized

application/json

404

Group not found

application/json

delete

/groups/{group_id}/participants

HTTPcURLJavaScriptPython

DELETE /groups/{group_id}/participants HTTP/1.1
Host: waba-v2.360dialog.io
D360-API-KEY: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 6

"text"

{}