Install Self-Hosted
Get Started on Cloud
BasicsPipelinesActions & ServicesEnvironmentsIntegrationsTargetsTestsDomainsSandboxesAgents & Tunnels

Create

View as Markdown
  • POST
  • /workspaces
  • /:workspace
  • /groups

Creates a new group. Restricted to admins only

Request

REQUIRED SCOPES
WORKSPACE
URL PARAMETERS
workspacerequiredstring
The human-readable ID of the workspace

Example: "my-company"

POST PARAMETERS
namerequiredstring
The name of the group
descriptionstring
The description of the group
auto_assign_to_new_projectsboolean
Whether to automatically assign group members to new projects
allow_add_new_projectsboolean
Whether group members are allowed to add new projects
allow_add_new_domains_on_owner_behalfboolean
Whether group members are allowed to buy new domains on behalf of the workspace owner
auto_assign_permission_set_idinteger
The ID of the permission set to automatically assign to new project members

Response

RESPONSE BODY
urlread-onlystring
API endpoint to GET this object
html_urlread-onlystring
Web URL to view this object in Buddy.works
idinteger
The ID of the group
namestring
The name of the group
descriptionstring
The description of the group
auto_assign_to_new_projectsboolean
Whether to automatically assign group members to new projects
allow_add_new_projectsboolean
Whether group members are allowed to add new projects
allow_add_new_domains_on_owner_behalfboolean
Whether group members are allowed to buy new domains on behalf of the workspace owner
auto_assign_permission_set_idinteger
The ID of the permission set to automatically assign to new project members

Last modified on Jan 26, 2026

Previous pageAddNext pageList

Request example

curl -X POST "https://api.buddy.works/workspaces/:workspace/groups" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{
  "name": "developers",
  "description": "Development team members",
  "auto_assign_to_new_projects": true,
  "allow_add_new_projects": false,
  "allow_add_new_domains_on_owner_behalf": false,
  "auto_assign_permission_set_id": 1
}'