---
title: "Create a monitor group"
method: POST
path: "/monitor-groups"
tags: ["Monitor Groups"]
---

# Create a monitor group

`POST /monitor-groups`

Create a new monitor group with optional initial monitors. Monitors can be assigned by providing their IDs or by specifying existing group IDs whose monitors should be moved.

## Request body

- CreateMonitorGroupDto
  - `name` string, required — Name of the monitor group
  - `monitorIds` number[] — List of monitor IDs to be assigned to this group
  - `groupIds` number[] — List of group IDs whose monitors should be moved to this new group

## Response `201`

Monitor group created successfully

- MonitorGroupDto
  - `id` number, required
  - `name` string, required
  - `createdAt` union, required
    - unknown
    - string
  - `updatedAt` union, required
    - unknown
    - string

## Other responses

- `400` — Validation error (invalid name, monitorIds, or groupIds)
- `401` — Unauthorized - invalid or missing authentication
- `403` — Forbidden - no write permission or monitor-groups feature not available
- `429` — Rate limit exceeded

---

[API](https://skmtc.net/uptimerobot/apis/uptimerobot-api.md) · [All operations](https://skmtc.net/uptimerobot/apis/uptimerobot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/uptimerobot/uptimerobot-api/revisions/2b6fa8c427ba/schema)