Create a group

View as Markdown
POST
/groups

Creates a new group that can be referenced in access policies, role assignments or user membership management.

Creation of more than two groups requires an active Pro plan subscription.

Authorization

API-Key
headerX-API-KEY<token>

MonoCloud APIs require authentication with an API key. Retrieve your key from the Tenant Settings section of the MonoCloud dashboard and include it in the request header as: X-API-Key: <your_api_key>

Request Body

application/json

The request payload used to create a group.

TypeScript Definitions

Use the request body type in TypeScript.

Create Group Request: Used to create a new group.

Response Headers

201

location?string

Returns the location header

Formaturi

Response Body

201

application/json

Group was created successfully

TypeScript Definitions

Use the response body type in TypeScript.

Group: Represents a group used to organize users and client assignments.

Errors

401Unauthorized

403Forbidden

curl -X POST "https://your-domain.us.monocloud.com/api/groups" \  -H "X-API-KEY: <token>" \  -H "Content-Type: application/json" \  -d '{    "name": "string"  }'
{  "group_id": "306db4e0-7449-4501-b76f-075576fe2d8f",  "type": "custom",  "name": "string",  "description": null,  "is_auto_assigned": true,  "users_assigned": 0,  "clients_assigned": 0,  "creation_time": 0,  "last_updated": 0,  "last_assigned": 0}
© 2026 MonoCloud. All rights reserved.