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.

Base

URL
Select language
https://graph.facebook.com

Endpoints

GET /{Version}/{group_id}/join_requests

GetApprove aone listor of openmore join requests for a group

Request Syntax

GETPOST /{Version}/{group_id}/join_requests
Try it
Select language
Select status code
curl--requestGET \{
--url"messaging_product"'https://graph.facebook.com/{Version}/{group_id}/j: oin_requests' "\"whatsapp\""
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
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
Media type of the request body
Path Parameters
Versionstring·required
group_idstring·required
Group ID
ResponsesRequest BodyRequired
Get a list of open join requests for a group
200
List of join requests
Content Type: application/json
Schema: object
Show child attributes
datamessaging_product"whatsapp"·required
join_requestsarray of objectstring·required
Array of join request IDs to approve
Show child attributes
data[join_requests[]object
Show child attributes
join_request_idstring
Join request ID
wa_idstring
WhatsApp user ID
creation_timestampinteger
Unix timestamp indicating when the join request was created
pagingPagingInfo
Show child attributes
cursorsobject
Show child attributes
beforestring
Before cursor
afterstring
After cursor
previousstring
Previous page URL
nextstring
Next page URL
Select language
curl--requestGET \
--url'https://graph.facebook.com/{Version}/{group_id}/join_requests' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'

POST /{Version}/{group_id}/join_requests

Responses
Approve one or more join requests

Request Syntax

POST /{Version}/{group_id}/join_requests
Try200 it
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
curl--request POST \
--url'https://graph.facebook.com/{Version}/{group_id}/join_requests' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code
{
"messaging_product": "\"whatsapp\""
}

DELETE /{Version}/{group_id}/join_requests

Reject one or more join requests

Request Syntax

DELETE /{Version}/{group_id}/join_requests
Try it
Select language
Select status code
{
"messaging_product": "\"whatsapp\""
}
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
Media type of the request body
Path Parameters
Versionstring·required
group_idstring·required
Group ID
Request BodyRequired
Content Type: application/json
Schema: object
Show child attributes
messaging_product"whatsapp"·required
join_requestsarray of string·required
Array of join request IDs to approvereject
Show child attributes
join_requests[]string
Join request ID
Responses
ApproveReject one or more join requests
200
Join requests approvalrejection response
Content Type: application/json
Schema: object
Show child attributes
messaging_productstring
approved_join_requestsrejected_join_requestsarray of string
Show child attributes
approved_join_requests[rejected_join_requests[]string
ID of approvedrejected 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
curl--request POST \
--url'https://graph.facebook.com/{Version}/{group_id}/join_requests' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code
{
"messaging_product": "\"whatsapp\""
}

DELETE /{Version}/{group_id}/join_requests

Reject one or more join requests

Request Syntax

DELETE /{Version}/{group_id}/join_requests
Try it
Select language
curl--request DELETE \
--url'https://graph.facebook.com/{Version}/{group_id}/join_requests' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code
{
"messaging_product": "\"whatsapp\""
}
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
Media type of the request body
Path Parameters
Versionstring·required
group_idstring·required
Group ID
Request BodyRequired
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
curl--request DELETE \
--url'https://graph.facebook.com/{Version}/{group_id}/join_requests' \
--header'Authorization: Bearer <Token>' \
--header'Content-Type: application/json' \
--data'{}'
Select status code
{
"messaging_product": "\"whatsapp\""
}

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
Back to top