---
title: "Create an Alert Grouping Setting"
method: POST
path: "/alert_grouping_settings"
tags: ["Alert Grouping Settings"]
---

# Create an Alert Grouping Setting

`POST /alert_grouping_settings`

Create a new Alert Grouping Setting.

The settings part of Alert Grouper service allows us to create Alert Grouping Settings and configs that are required to be used during grouping of the alerts.

This endpoint will be used to create an instance of AlertGroupingSettings for either one service or many services that are in the alert group setting.

Scoped OAuth requires: `services.write`

## Headers

- `Accept` string, required
- `Content-Type` 'application/json', required

## Request body

- object
  - `alert_grouping_setting` AlertGroupingSetting, required — unresolved $ref

## Response `201`

The new Alert Grouping Setting.

- object
  - `alert_grouping_setting` AlertGroupingSetting, required — unresolved $ref

## Other responses

- `400` — Caller provided invalid arguments. Please review the response for error details. Retrying with the same arguments will *not* work.
- `401` — Caller did not supply credentials or did not provide the correct credentials. If you are using an API key, it may be invalid or your Authorization header may be malformed.
- `403` — Caller is not authorized to view the requested resource. While your authentication is valid, the authenticated user or token does not have permission to perform this action.

---

[API](https://skmtc.dev/pagerduty/apis/rest-api.md) · [All operations](https://skmtc.dev/pagerduty/apis/rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/pagerduty/rest-api/revisions/b679a8f3f02c/schema)