POST
/api/v1/groups
Creates a monitor group for the team, appended to the end of its sibling set. Assign monitors to it with the group_id field on the monitor endpoints.
Request Body
| Parameter | Type | Description |
|---|---|---|
name | string | Required. Unique within the team, max 60 characters |
description | string | Optional, max 255 characters |
parent_id | integer | Optional. Must be a top-level group in your team (one level of nesting) |
Response
Returns the created group with status 201, appended to the end of its sibling set.
{
"id": 7,
"name": "Agency Clients",
"description": "Everything billed monthly",
"parent_id": null,
"sort_order": 0,
"monitors_count": 12,
"created_at": "2026-08-21T14:02:11Z",
"updated_at": "2026-08-21T14:02:11Z"
}