Create

POST
/workspaces
/:workspace
/groups

Creates a new group. Restricted to admins only.

Request

REQUIRED SCOPES

WORKSPACE

URL PARAMETERS

workspacerequiredstring

The workspace name.

POST PARAMETERS

namerequiredstring

The name of the group.

descriptionstring

The description of the group.

Last modified on Jan 19, 2026

Delete Add

Request example


curl -X POST "https://api.buddy.works/workspaces/:workspace/groups" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "JAVA",
  "description": "Java developers"
}'

Response

EXAMPLE RESPONSE
{
  "url": "https://api.buddy.works/workspaces/buddy/groups/1",
  "html_url": "https://app.buddy.works/buddy/group/1",
  "id": 1,
  "name": "JAVA",
  "description": "Java developers"
}

STATUS
201 Created