MEmeta

Create Group

Create a new group and get an invite link

post/{Version}/{Phone-Number-ID}/groups

Request

  • Base URL
    https://graph.facebook.com
  • URL
    https://graph.facebook.com/{Version}/{Phone-Number-ID}/groups
  • Auth
    HTTP bearer

Path parameters

Versionstring required
Phone-Number-IDstring required

Business phone number ID

Headers

User-Agentstring
Example:Meta-Business-Messaging-OpenAPI/1.0.0;spec=2025-10-21

The user agent string identifying the client software making the request.

Authorizationstring required
Example:Bearer EAABwzLixnjYBOzYmNMJJGfHq9DgNh...

Bearer token for API authentication. This should be a valid access token obtained through the appropriate OAuth flow or system user token.

Content-Type'application/json' | 'application/x-www-form-urlencoded' | 'multipart/form-data' required
Example:application/json

Media type of the request body

Request body

messaging_product'whatsapp' required

Messaging product

subjectstring required

Group subject. Maximum 128 characters. Whitespace is trimmed.

descriptionstring

Group description. Maximum 2048 characters.

join_approval_mode'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

Example request

{
  "subject": "New Purchase Inquiry",
  "description": "Jim, an existing client, would like to learn about new car purchase options for current year models."
}

Response

Group creation request submitted successfully

messaging_productstring
request_idstring

Group creation request ID

Example response

{
  "messaging_product": "whatsapp",
  "request_id": "106540352242922"
}

Changes

No recorded changes to this operation across all 5 revisions of this API.