Create WhatsApp Group
neuron_create_groupCreate a new WhatsApp group and seed its members from any combination of sources: other groups (combine/copy), contact lists, individual contacts, pasted phone numbers, or the whole address book. Optionally pass a unique slug to address the group later without its JID. Members blocked by privacy come back in the failed list. Uses the org's default connected session unless channelId is given.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| slug | No | Optional org-unique handle (lowercase letters, numbers, hyphens) | |
| tags | No | Keep only contacts carrying one of these tags | |
| phones | No | Raw phone numbers, e.g. pasted from a CSV | |
| listIds | No | Contact list ids or slugs — pulls every member | |
| subject | Yes | Group name | |
| ifExists | No | When the slug is already taken: 'error' (default) fails, 'return' returns the existing group and adds any given members to it (idempotent create). | |
| channelId | No | Session (connected WhatsApp number) UUID. Omit to use the default. | |
| contactIds | No | Existing contact ids | |
| allContacts | No | Union the org's entire address book | |
| description | No | Optional group description | |
| fromGroupIds | No | Copy/combine members live from these WhatsApp group JIDs | |
| excludeListIds | No | Subtract every member of these lists |