Create New Group - Virtuous API Docs

curl --request POST \ --url https://api.vomo.org/v1/groups \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data ' { "name": "Morning Crew", "description": "A group for the morning crew to organize", "member_moniker": "Member", "subgroup_moniker": "Subgroup", "created_by_user_id": "1", "parent_id": "1", "members": [ "1" ] } '

{ "data": { "id": 604, "name": "Weekend Warriors", "description": "Volunteers available on weekends.", "parent_id": null, "has_subgroups": false, "created_at": "2025-11-21T09:00:00+00:00", "updated_at": "2025-11-21T09:00:00+00:00" } }

Authorizations

Authorization

string

header

required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Group to create

Request body for creating or updating a group.

name

string

required

The name of the group

Example:

"Morning Crew"

description

string | null

A description for the group

Example:

"A group for the morning crew to organize"

member_moniker

string

A word describing a group member

Example:

"Member"

subgroup_moniker

string

A word describing subgroups

Example:

"Subgroup"

created_by_user_id

integer

Optional. If provided, must be an existing user who is a member of the organization.

Example:

"1"

parent_id

integer

The VOMO Group ID to set as the parent group of the newly created group

Example:

"1"

members

integer[]

User IDs to set as the group's membership. On create (POST), these become the initial members. On update (PUT), this replaces the existing membership — any current member omitted from the array is removed from the group. Pass an empty array to clear all members.

Response

Returns the newly created group record. Note: on success this endpoint returns 200 OK, not 201 Created.

data

object

List of Groups

Show child attributes