WhatsApp Business Cloud API - Groups Management API | Developer Documentation
WhatsApp Business Cloud API - Groups Management API
Copy for LLM
Version
Create and manage WhatsApp Business groups with approval settings.
Returns invite links for adding participants to groups.
Retrieve active group lists with pagination support.
Select language
POST /{Version}/{Phone-Number-ID}/groups
Create a new group and get an invite link
Request Syntax
Try it
Select language
Select status code
Header Parameters
User-Agentstring
The user agent string identifying the client software making the request.
Authorizationstring·required
Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.
Content-TypeOne of "application/json", "application/x-www-form-urlencoded", "multipart/form-data"·required
Path Parameters
Versionstring·required
Phone-Number-IDstring·required
Business phone number ID
Required
Content Type: application/json
Schema: object
Show child attributes
messaging_product"whatsapp"·required
Messaging product
subjectstring·required
Group subject. Maximum 128 characters. Whitespace is trimmed.
descriptionstring
Group description. Maximum 2048 characters.
join_approval_modeOne of "approval_required", "auto_approve"
Indicates if WhatsApp users who click the invitation link can join the group with or without being approved first.
approval_required: WhatsApp users must be approved via join request before they can access the group
auto_approve: WhatsApp users can join the group without approval
Responses
Create a new group and get an invite link
200
Group creation request submitted successfully
Content Type: application/json
Schema: object
Show child attributes
messaging_productstring
request_idstring
Group creation request ID
400
Bad Request - Invalid request parameters
Content Type: application/json
Schema: ErrorResponse
Show child attributes
ErrorResponse
errorErrorObject·required
Show child attributes
messagestring·required
Human-readable description of the error
typestring·required
Error type classification
codeinteger·required
Numeric error code
401
Unauthorized - Invalid or missing access token
Content Type: application/json
Schema: ErrorResponse
Show child attributes
ErrorResponse
errorErrorObject·required
Show child attributes
messagestring·required
Human-readable description of the error
typestring·required
Error type classification
codeinteger·required
Numeric error code
500
Internal Server Error - An unexpected error occurred
Content Type: application/json
Schema: ErrorResponse
Show child attributes
ErrorResponse
errorErrorObject·required
Show child attributes
messagestring·required
Human-readable description of the error
typestring·required
Error type classification
codeinteger·required
Numeric error code
Select language
Select status code
Authentication
|
Scheme |
Type |
Location |
|
bearerAuth |
HTTP Bearer |
Header: Authorization |
Usage Examples
bearerAuth:
Include
Authorization: Bearer your-token-here in request headersGlobal Authentication Requirements
All endpoints require:
bearerAuth
No comments to display
No comments to display