# WhatsApp Business Cloud API - Groups Management API | Developer Documentation

<div id="bkmrk-whatsapp-business-cl"><div><div>## WhatsApp Business Cloud API - Groups Management 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-management-api-developer-documentation)</div></div></div><div><div>Version</div></div><div><div><div><div><div><div><span><span>Create and manage WhatsApp Business groups with approval settings.</span></span></div></div><div><div><span><span>Returns invite links for adding participants to groups.</span></span></div></div><div><div><span><span>Retrieve active group lists with pagination support.</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%7Bpho"><div id="bkmrk-post-%2F%7Bversion%7D%2F%7Bpho-1"><div>### POST /{Version}/{Phone-Number-ID}/groups

</div></div></div><div><div><div><div><div><div><span><span>Create a new group and get an invite link</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>Phone-Number-ID</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Business phone number 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-6"><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><div><span><span>Messaging product</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>subject</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Group subject. Maximum 128 characters. Whitespace is trimmed.</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>description</span><span>string</span></div><div><div><div><div><div><div><span><span>Group description. Maximum 2048 characters.</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>join\_approval\_mode</span><span>One of "approval\_required", "auto\_approve"</span></div><div><div><div><div><div><div><span><span>Indicates if WhatsApp users who click the invitation link can join the group with or without being approved first.</span></span></div></div><div><span><span>approval\_required: WhatsApp users must be approved via join request before they can access the group</span></span></div><div><span><span>auto\_approve: WhatsApp users can join the group without approval</span></span></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>Create a new group and get an invite link</span></span></div></div></div></div></div></div><div><span>200</span><div><div><div><div><div><div><span><span>Group creation request submitted successfully</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>request\_id</span><span>string</span></div><div><div><div><div><div><div><span><span>Group creation request ID</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><span>400</span><div><div><div><div><div><div><span><span>Bad Request - Invalid request parameters</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>ErrorResponse</span></div><div><div><div id="bkmrk-show-child-attribute-8"><div><span>Show child attributes</span></div></div><div id="bkmrk-errorresponseerrorer"><div>---

<div><span>ErrorResponse</span></div><div>---

<div><div><span>error</span><span>ErrorObject</span><span>·</span><span>required</span></div></div><div><div><div id="bkmrk-show-child-attribute-9"><div><span>Show child attributes</span></div></div><div id="bkmrk-messagestring%C2%B7requir"><div><div>---

<div><div><span>message</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Human-readable description of the error</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>type</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Error type classification</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>code</span><span>integer</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Numeric error code</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><span>401</span><div><div><div><div><div><div><span><span>Unauthorized - Invalid or missing access token</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>ErrorResponse</span></div><div><div><div id="bkmrk-show-child-attribute-10"><div><span>Show child attributes</span></div></div><div id="bkmrk-errorresponseerrorer-1"><div>---

<div><span>ErrorResponse</span></div><div>---

<div><div><span>error</span><span>ErrorObject</span><span>·</span><span>required</span></div></div><div><div><div id="bkmrk-show-child-attribute-11"><div><span>Show child attributes</span></div></div><div id="bkmrk-messagestring%C2%B7requir-1"><div><div>---

<div><div><span>message</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Human-readable description of the error</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>type</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Error type classification</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>code</span><span>integer</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Numeric error code</span></span></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div></div><div><span>500</span><div><div><div><div><div><div><span><span>Internal Server Error - An unexpected error occurred</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>ErrorResponse</span></div><div><div><div id="bkmrk-show-child-attribute-12"><div><span>Show child attributes</span></div></div><div id="bkmrk-errorresponseerrorer-2"><div>---

<div><span>ErrorResponse</span></div><div>---

<div><div><span>error</span><span>ErrorObject</span><span>·</span><span>required</span></div></div><div><div><div id="bkmrk-show-child-attribute-13"><div><span>Show child attributes</span></div></div><div id="bkmrk-messagestring%C2%B7requir-2"><div><div>---

<div><div><span>message</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Human-readable description of the error</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>type</span><span>string</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Error type classification</span></span></div></div></div></div></div></div></div></div><div>---

<div><div><span>code</span><span>integer</span><span>·</span><span>required</span></div><div><div><div><div><div><div><span><span>Numeric error code</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>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>