Skip to main content

WhatsApp Business Cloud API - Groups Join Requests API | Developer Documentation

WhatsApp Business Cloud API - Groups Join Requests API

Copy for LLM
Version
The Groups API gives you simple functions to control groups through their lifecycle.
When you create a new group, an invite link is created for inviting participants to the group.
Since you cannot manually add participants to the group, simply send a message with your invite link to WhatsApp users who you would like to join the group.

Select language


POST /{Version}/{group_id}/join_requests

Approve one or more join requests

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
group_idstring·required
Group ID
Required
Content Type: application/json
Schema: object
Show child attributes

messaging_product"whatsapp"·required

join_requestsarray of string·required
Array of join request IDs to approve
Show child attributes

join_requests[]string
Join request ID
Responses
Approve one or more join requests
200
Join requests approval response
Content Type: application/json
Schema: object
Show child attributes

messaging_productstring

approved_join_requestsarray of string
Show child attributes

approved_join_requests[]string
ID of approved join request

failed_join_requestsarray of object
Show child attributes

failed_join_requests[]object
Show child attributes

join_request_idstring

errorsarray of Error
Show child attributes

errors[]Error
Show child attributes

codeinteger
Error code

messagestring
Error message

titlestring
Error title

error_dataobject
Show child attributes

detailsstring
Error details

errorsarray of Error
Show child attributes

errors[]Error
Show child attributes

codeinteger
Error code

messagestring
Error message

titlestring
Error title

error_dataobject
Show child attributes

detailsstring
Error details
Select language

Select status code


DELETE /{Version}/{group_id}/join_requests

Reject one or more join requests

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
group_idstring·required
Group ID
Required
Content Type: application/json
Schema: object
Show child attributes

messaging_product"whatsapp"·required

join_requestsarray of string·required
Array of join request IDs to reject
Show child attributes

join_requests[]string
Join request ID
Responses
Reject one or more join requests
200
Join requests rejection response
Content Type: application/json
Schema: object
Show child attributes

messaging_productstring

rejected_join_requestsarray of string
Show child attributes

rejected_join_requests[]string
ID of rejected join request

failed_join_requestsarray of object
Show child attributes

failed_join_requests[]object
Show child attributes

join_request_idstring

errorsarray of Error
Show child attributes

errors[]Error
Show child attributes

codeinteger
Error code

messagestring
Error message

titlestring
Error title

error_dataobject
Show child attributes

detailsstring
Error details

errorsarray of Error
Show child attributes

errors[]Error
Show child attributes

codeinteger
Error code

messagestring
Error message

titlestring
Error title

error_dataobject
Show child attributes

detailsstring
Error details
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 headers

Global Authentication Requirements

All endpoints require:
bearerAuth