---
title: "Changes to Create Alert Configuration"
method: POST
path: "/api/v1/alert-configurations"
---

# Changes to Create Alert Configuration

`POST /api/v1/alert-configurations`

> Every recorded change to this operation, newest first.

## Timeline

Changed in 1 of 2 revisions.

- **2026-11-03** `922fc15f43a7`: 4 breaking, 15 warning, 21 info

## Changes

- **2026-11-03** `922fc15f43a7`: 4 breaking, 15 warning, 21 info
  - request property `dueInterval/oneOf[subschema #1]/` was restricted to a list of enum values
  - request property `groupBy/oneOf[subschema #1]/` was restricted to a list of enum values
  - the request property `bambooAlertId` became required
  - response property `lastEdited` list-of-types was widened by adding types `string` to media type `application/json` of response `201`
  - the `dueWithin/oneOf[subschema #1]/` request property's max was set to `32767.00`
  - removed the request property `additionalRecipientEmails`
  - removed the request property `editorUserId`
  - removed the request property `employeeIds`
  - removed the request property `id`
  - removed the request property `lastEdited`
  - removed the request property `listValueIds`
  - removed the request property `userIds`
  - added the new `days` enum value to the `dueInterval/oneOf[subschema #1]/` response property for the response status `201`
  - added the new `department` enum value to the `groupBy/oneOf[subschema #1]/` response property for the response status `201`
  - added the new `division` enum value to the `groupBy/oneOf[subschema #1]/` response property for the response status `201`
  - added the new `jobTitle` enum value to the `groupBy/oneOf[subschema #1]/` response property for the response status `201`
  - added the new `location` enum value to the `groupBy/oneOf[subschema #1]/` response property for the response status `201`
  - added the new `months` enum value to the `dueInterval/oneOf[subschema #1]/` response property for the response status `201`
  - added the new `weeks` enum value to the `dueInterval/oneOf[subschema #1]/` response property for the response status `201`
  - api operation id `a05e93bc2eb9c39a40fbd71e6e07f3c6` removed and replaced with `create-alert-configuration`
  - api tag `Alerts` added
  - api tag `Alert Configurations` removed
  - the `includeLocation` request property default value `false` was added
  - the `includePosition` request property default value `false` was added
  - the `limitTrainingToRequired` request property default value `true` was added
  - the `schedule` request property default value `daily` was added
  - the `sendToAdmin` request property default value `false` was added
  - the `sendToEmployee` request property default value `true` was added
  - the `sendToManager` request property default value `false` was added
  - added the new `days` enum value to the request property `dueInterval/oneOf[subschema #1]/`
  - added the new `department` enum value to the request property `groupBy/oneOf[subschema #1]/`
  - added the new `division` enum value to the request property `groupBy/oneOf[subschema #1]/`
  - added the new `jobTitle` enum value to the request property `groupBy/oneOf[subschema #1]/`
  - added the new `location` enum value to the request property `groupBy/oneOf[subschema #1]/`
  - added the new `months` enum value to the request property `dueInterval/oneOf[subschema #1]/`
  - added the new `weeks` enum value to the request property `dueInterval/oneOf[subschema #1]/`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `400`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `403`
  - media type `application/json` was changed to a more specific media type `application/problem+json` for the response status `500`
  - added the non-success response with the status `401`

---

[Operation](https://skmtc.dev/bamboohr/apis/bamboohr-api/docs/api/v1/alert-configurations/post.md) - [API](https://skmtc.dev/bamboohr/apis/bamboohr-api.md) - [Page](https://skmtc.dev/bamboohr/apis/bamboohr-api/changes/api/v1/alert-configurations/post)