Skip to content

Notification group summaries

GET /api/v1/notification_groups / MCP list_notification_groups. Requires notification_groups:read; accepts limit and cursor.

{
"items": [
{
"id": "123",
"name": "Operations",
"delivery_configured": true
}
],
"next_cursor": null
}

delivery_configured means the group has channels, direct users or rosters. It does not prove an eligible user is currently on schedule, a delivery method is enabled or an alert was successfully delivered.

Use returned IDs in a check’s notification_group_ids. Supplying this field also requires notification_groups:assign, including on create.

The result omits recipient addresses and delivery credentials. This API does not create/edit/delete groups, channels, recipients or schedules. Use notification-group management in the signed-in UI.