Create Program Group

POST /siren/v1/program-groups

Creates a new program group. Optionally associates programs at creation time.

Request Body:

Field	Type	Required	Description
name	string	Yes	Display name for the group
description	string	Yes	Description of the group’s purpose
sorter	string	Yes	Sorting strategy: oldestBindingWins or newestBindingWins
programs	integer[]	No	Array of program IDs to associate with the group. IDs must reference existing programs. Programs already assigned to another group are silently skipped.

Example Request:

{
  "name": "Seasonal Promotions",
  "description": "Holiday and seasonal bonus programs that override the default commission.",
  "sorter": "newestBindingWins",
  "programs": [3, 7]
}

Example Response:

{
  "id": 2,
  "name": "Seasonal Promotions",
  "description": "Holiday and seasonal bonus programs that override the default commission.",
  "sorter": "newestBindingWins"
}

Returns 201 on success. The response includes the core fields of the newly created group. Program associations are created but not reflected in the response. Use GET /siren/v1/program-groups/{id}?fields=id,name,programIds to confirm them.