---
title: "Create an Analysis Group"
method: POST
path: "/v1/beam/analysis-groups"
tags: ["Analysis Groups"]
---

# Create an Analysis Group

`POST /v1/beam/analysis-groups`

Creating an Analysis Group allows to aggregate Feature Importance for a number of Analyses

## Request body

- PutAnalysisGroupRequest
  - `name` string, required — Name of an analysis group.
  - `analysis_ids` string[], required — The list of existing analysis IDs to include in the group. Analyses can belong to multiple groups. Analyses must have the same demand type (the `interval` must match and, for weekly analyses, `week_start_day` must also be consistent). Every analysis in the group must have the same `industry`, if set.
  - `demand_type` AnalysisGroupDemandTypeInput
    - `unit_descriptor` string — The description of the unit of demand, which specifies the type or measure being quantified (e.g., "Occupancy Rate", "Sales", "Number of Transactions").

## Response `201`

Successful Response

- AnalysisGroupIdResponse
  - `group_id` string — The autogenerated identifier for the analysis group.

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Bearer token scope insufficient

---

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