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

<div id="bkmrk-whatsapp-business-cl"><div><div>## WhatsApp Business Cloud API - Groups Join Requests API

<div><div><div><span>Copy for LLM</span></div></div><div>[<span>View as Markdown</span>](/books/meta-whatsapp/page/whatsapp-business-cloud-api-groups-join-requests-api-developer-documentation)</div></div></div><div><div>Version</div></div><div><div><div><div><div><div><span><span>The Groups API gives you simple functions to control groups through their lifecycle.</span></span></div></div><div><div><span><span>When you create a new group, an invite link is created for inviting participants to the group.</span></span></div></div><div><div><span><span>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.</span></span></div></div></div></div></div></div></div><div><div>---

<div><div><div><div><div><div><div><div>Select language</div></div></div></div>---

</div></div></div></div></div><div>---

<div><div><div id="bkmrk-post-%2F%7Bversion%7D%2F%7Bgro"><div id="bkmrk-post-%2F%7Bversion%7D%2F%7Bgro-1"><div>### POST /{Version}/{group\_id}/join\_requests

</div></div></div><div><div><div><div><div><div><span><span>Approve one or more join requests</span></span></div></div></div></div></div></div>#### Request Syntax

<div><div><div><div><div><div><span>Try it</span></div></div></div></div></div></div><div><div><div><div><div><div><div>Select language</div></div></div></div>---

</div><div><div><div><div><div><div>Select status code</div></div></div></div>---

</div></div></div></div><div><span>Header Parameters</span>---

<div><div><span>User-Agent</span><span>string</span></div><div><div><div><div><div><div><span><span>The user agent string identifying the client software making the request.</span></span></div></div></div></div></div></div></div><div><div><span>Authorization</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.</span></span></div></div></div></div></div></div></div><div><div><span>Content-Type</span><span>One of "application/json", "application/x-www-form-urlencoded", "multipart/form-data"</span><span>·</span><span>required</span></div></div></div><div><span>Path Parameters</span>---

<div><div><span>Version</span><span>string</span><span>·</span><span>required</span></div></div><div><div><span>group\_id</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Group ID</span></span></div></div></div></div></div></div></div></div><div><span>Required</span>---

<div><div><span>Content Type: </span><span>application/json</span></div><div><div><span>Schema: </span><span>object</span></div><div><div><div id="bkmrk-show-child-attribute-5"><div><span>Show child attributes</span></div></div><div id="bkmrk-messaging_product%22wh"><div><div>---

<div><div><span>messaging\_product</span><span>"whatsapp"</span><span>·</span><span>required</span></div></div></div><div>---

<div><div><span>join\_requests</span><span>array of string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Array of join request IDs to approve</span></span></div></div></div></div></div></div></div><div><div><div id="bkmrk-show-child-attribute-6"><div><span>Show child attributes</span></div></div><div id="bkmrk-join_requests%5B%5Dstrin"><div><div>---

<div><div><span>join\_requests\[\]</span><span>string</span></div><div><div><div><div><div><div><span><span>Join request ID</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><span>Responses</span>---

<div><div><div><div><div><div><span><span>Approve one or more join requests</span></span></div></div></div></div></div></div><div><span>200</span><div><div><div><div><div><div><span><span>Join requests approval response</span></span></div></div></div></div></div></div><div><div><span>Content Type: </span><span>application/json</span></div><div><div><span>Schema: </span><span>object</span></div><div><div><div id="bkmrk-show-child-attribute-7"><div><span>Show child attributes</span></div></div><div id="bkmrk-messaging_productstr"><div><div>---

<div><div><span>messaging\_product</span><span>string</span></div></div></div><div>---

<div><div><span>approved\_join\_requests</span><span>array of string</span></div></div><div><div><div id="bkmrk-show-child-attribute-8"><div><span>Show child attributes</span></div></div><div id="bkmrk-approved_join_reques"><div><div>---

<div><div><span>approved\_join\_requests\[\]</span><span>string</span></div><div><div><div><div><div><div><span><span>ID of approved join request</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div><div>---

<div><div><span>failed\_join\_requests</span><span>array of object</span></div></div><div><div><div id="bkmrk-show-child-attribute-9"><div><span>Show child attributes</span></div></div><div id="bkmrk-failed_join_requests"><div><div>---

<div><div><span>failed\_join\_requests\[\]</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-10"><div><span>Show child attributes</span></div></div><div id="bkmrk-join_request_idstrin-1"><div><div>---

<div><div><span>join\_request\_id</span><span>string</span></div></div></div><div>---

<div><div><span>errors</span><span>array of Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-11"><div><span>Show child attributes</span></div></div><div id="bkmrk-errors%5B%5Derrorshow-ch"><div><div>---

<div><div><span>errors\[\]</span><span>Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-12"><div><span>Show child attributes</span></div></div><div id="bkmrk-codeintegererror-cod"><div><div>---

<div><div><span>code</span><span>integer</span></div><div><div><div><div><div><div><span><span>Error code</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>message</span><span>string</span></div><div><div><div><div><div><div><span><span>Error message</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>title</span><span>string</span></div><div><div><div><div><div><div><span><span>Error title</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>error\_data</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-13"><div><span>Show child attributes</span></div></div><div id="bkmrk-detailsstringerror-d"><div><div>---

<div><div><span>details</span><span>string</span></div><div><div><div><div><div><div><span><span>Error details</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div>---

<div><div><span>errors</span><span>array of Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-14"><div><span>Show child attributes</span></div></div><div id="bkmrk-errors%5B%5Derrorshow-ch-1"><div><div>---

<div><div><span>errors\[\]</span><span>Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-15"><div><span>Show child attributes</span></div></div><div id="bkmrk-codeintegererror-cod-1"><div><div>---

<div><div><span>code</span><span>integer</span></div><div><div><div><div><div><div><span><span>Error code</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>message</span><span>string</span></div><div><div><div><div><div><div><span><span>Error message</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>title</span><span>string</span></div><div><div><div><div><div><div><span><span>Error title</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>error\_data</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-16"><div><span>Show child attributes</span></div></div><div id="bkmrk-detailsstringerror-d-1"><div><div>---

<div><div><span>details</span><span>string</span></div><div><div><div><div><div><div><span><span>Error details</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><div><div><div><div><div><div>Select language</div></div></div></div>---

</div><div><div><div><div><div><div>Select status code</div></div></div></div>---

</div></div></div></div></div></div><div>---

<div><div><div id="bkmrk-delete-%2F%7Bversion%7D%2F%7Bg"><div id="bkmrk-delete-%2F%7Bversion%7D%2F%7Bg-1"><div>### DELETE /{Version}/{group\_id}/join\_requests

</div></div></div><div><div><div><div><div><div><span><span>Reject one or more join requests</span></span></div></div></div></div></div></div>#### Request Syntax

<div><div><div><div><div><div><span>Try it</span></div></div></div></div></div></div><div><div><div><div><div><div><div>Select language</div></div></div></div>---

</div><div><div><div><div><div><div>Select status code</div></div></div></div>---

</div></div></div></div><div><span>Header Parameters</span>---

<div><div><span>User-Agent</span><span>string</span></div><div><div><div><div><div><div><span><span>The user agent string identifying the client software making the request.</span></span></div></div></div></div></div></div></div><div><div><span>Authorization</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.</span></span></div></div></div></div></div></div></div><div><div><span>Content-Type</span><span>One of "application/json", "application/x-www-form-urlencoded", "multipart/form-data"</span><span>·</span><span>required</span></div></div></div><div><span>Path Parameters</span>---

<div><div><span>Version</span><span>string</span><span>·</span><span>required</span></div></div><div><div><span>group\_id</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Group ID</span></span></div></div></div></div></div></div></div></div><div><span>Required</span>---

<div><div><span>Content Type: </span><span>application/json</span></div><div><div><span>Schema: </span><span>object</span></div><div><div><div id="bkmrk-show-child-attribute-17"><div><span>Show child attributes</span></div></div><div id="bkmrk-messaging_product%22wh-1"><div><div>---

<div><div><span>messaging\_product</span><span>"whatsapp"</span><span>·</span><span>required</span></div></div></div><div>---

<div><div><span>join\_requests</span><span>array of string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Array of join request IDs to reject</span></span></div></div></div></div></div></div></div><div><div><div id="bkmrk-show-child-attribute-18"><div><span>Show child attributes</span></div></div><div id="bkmrk-join_requests%5B%5Dstrin-1"><div><div>---

<div><div><span>join\_requests\[\]</span><span>string</span></div><div><div><div><div><div><div><span><span>Join request ID</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><span>Responses</span>---

<div><div><div><div><div><div><span><span>Reject one or more join requests</span></span></div></div></div></div></div></div><div><span>200</span><div><div><div><div><div><div><span><span>Join requests rejection response</span></span></div></div></div></div></div></div><div><div><span>Content Type: </span><span>application/json</span></div><div><div><span>Schema: </span><span>object</span></div><div><div><div id="bkmrk-show-child-attribute-19"><div><span>Show child attributes</span></div></div><div id="bkmrk-messaging_productstr-1"><div><div>---

<div><div><span>messaging\_product</span><span>string</span></div></div></div><div>---

<div><div><span>rejected\_join\_requests</span><span>array of string</span></div></div><div><div><div id="bkmrk-show-child-attribute-20"><div><span>Show child attributes</span></div></div><div id="bkmrk-rejected_join_reques"><div><div>---

<div><div><span>rejected\_join\_requests\[\]</span><span>string</span></div><div><div><div><div><div><div><span><span>ID of rejected join request</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div><div>---

<div><div><span>failed\_join\_requests</span><span>array of object</span></div></div><div><div><div id="bkmrk-show-child-attribute-21"><div><span>Show child attributes</span></div></div><div id="bkmrk-failed_join_requests-1"><div><div>---

<div><div><span>failed\_join\_requests\[\]</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-22"><div><span>Show child attributes</span></div></div><div id="bkmrk-join_request_idstrin-2"><div><div>---

<div><div><span>join\_request\_id</span><span>string</span></div></div></div><div>---

<div><div><span>errors</span><span>array of Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-23"><div><span>Show child attributes</span></div></div><div id="bkmrk-errors%5B%5Derrorshow-ch-2"><div><div>---

<div><div><span>errors\[\]</span><span>Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-24"><div><span>Show child attributes</span></div></div><div id="bkmrk-codeintegererror-cod-2"><div><div>---

<div><div><span>code</span><span>integer</span></div><div><div><div><div><div><div><span><span>Error code</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>message</span><span>string</span></div><div><div><div><div><div><div><span><span>Error message</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>title</span><span>string</span></div><div><div><div><div><div><div><span><span>Error title</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>error\_data</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-25"><div><span>Show child attributes</span></div></div><div id="bkmrk-detailsstringerror-d-2"><div><div>---

<div><div><span>details</span><span>string</span></div><div><div><div><div><div><div><span><span>Error details</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div>---

<div><div><span>errors</span><span>array of Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-26"><div><span>Show child attributes</span></div></div><div id="bkmrk-errors%5B%5Derrorshow-ch-3"><div><div>---

<div><div><span>errors\[\]</span><span>Error</span></div></div><div><div><div id="bkmrk-show-child-attribute-27"><div><span>Show child attributes</span></div></div><div id="bkmrk-codeintegererror-cod-3"><div><div>---

<div><div><span>code</span><span>integer</span></div><div><div><div><div><div><div><span><span>Error code</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>message</span><span>string</span></div><div><div><div><div><div><div><span><span>Error message</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>title</span><span>string</span></div><div><div><div><div><div><div><span><span>Error title</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>error\_data</span><span>object</span></div></div><div><div><div id="bkmrk-show-child-attribute-28"><div><span>Show child attributes</span></div></div><div id="bkmrk-detailsstringerror-d-3"><div><div>---

<div><div><span>details</span><span>string</span></div><div><div><div><div><div><div><span><span>Error details</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><div><div><div><div><div><div>Select language</div></div></div></div>---

</div><div><div><div><div><div><div>Select status code</div></div></div></div>---

</div></div></div></div></div></div></div><div><div id="bkmrk-authentication"><div id="bkmrk-authentication-1"><div>### Authentication

</div></div></div><div><table><tbody><tr><td><div>**Scheme**</div></td><td><div>**Type**</div></td><td><div>**Location**</div></td></tr><tr><td><div><div><div><div><div><div><div><span><span>bearerAuth</span></span></div></div></div></div></div></div></div></td><td><div><div><div><div><div><div><div><span><span>HTTP Bearer</span></span></div></div></div></div></div></div></div></td><td><div><div><div><div><div><div><div><span><span>Header: </span></span>`<span><span>Authorization</span></span>`</div></div></div></div></div></div></div></td></tr></tbody></table>

</div><div>#### Usage Examples

<div><span>bearerAuth:</span><div><div><div><div><div><div><span><span>Include </span></span>`<span><span>Authorization: Bearer your-token-here</span></span>`<span><span> in request headers</span></span></div></div></div></div></div></div></div></div><div>#### Global Authentication Requirements

<div><span>All endpoints require:</span><div><div><div><div><div><div><span><span>bearerAuth</span></span></div></div></div></div></div></div></div></div></div></div>