Skip to main content
POST
Create New Group

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

Last modified on June 5, 2026