Create group

Create a new WhatsApp group chat. Returns the group ID and optionally an invite link.

Not available on Coexistence numbers. Requires a Cloud API-only number.

POST /v1/account-groups

Creates a new account group with a name and a list of social account IDs. Accounts can belong to different profiles; the caller must have access to every account's profile. Group names must be unique per user.

Request body

Content-Type: application/json

• name (string) required
• accountIds (array) required
• profileId (string) — Deprecated. Accepted for backward compatibility but ignored. Groups are no longer scoped to a single profile.

Example:

{
  "name": "Marketing Accounts",
  "accountIds": [
    "64e1f0a9e2b5af0012ab34cd",
    "64e1f0a9e2b5af0012ab34ce"
  ]
}

Responses

201 — Created

• message (string)
• group (object)

400 — Invalid request

401

409 — Group name already exists