---
title: "Create an experiment group"
method: POST
path: "/experiments/{experiment_id}/groups"
tags: ["Experiments"]
---

# Create an experiment group

`POST /experiments/{experiment_id}/groups`

Creates a new group for the specified experiment. Returns 201 with Location header.

## Path parameters

- `experiment_id` string, required

## Request body

- V4ExperimentGroupCreateRequest
  - `name` string, nullable — Group display name.
  - `is_control` boolean — Whether this is the control group.
  - `weight` number, required — Relative traffic weight for this group.
  - `remote_config_uid` string, nullable — Remote config UID to associate with this group.

## Response `201`

Experiment group created.

- V4ExperimentGroup
  - `object` string
  - `id` string — Group identifier.
  - `url` string — Canonical API path.
  - `name` string, nullable — Group display name.
  - `is_control` boolean — Whether this is the control group.
  - `weight` number — Relative traffic weight for this group.
  - `remote_config_uid` string, nullable — Remote config UID associated with this group. Mutually exclusive with `offering_uid` — a group carries at most one payload linkage.
  - `offering_uid` string, nullable — Offering UID associated with this group (price-split experiments). Mutually exclusive with `remote_config_uid`.
  - `offering_tag` integer, nullable — Tag of the attached offering (0 = default, 1 = variant). Populated only when `offering_uid` is set.
  - `created_at` string, date-time — ISO 8601 creation timestamp.
  - `updated_at` string, date-time — ISO 8601 last update timestamp.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized
- `404` — Experiment not found
- `415` — Unsupported Content-Type
- `429` — Too many requests
- `502` — Upstream service failure
- `504` — Upstream timeout

---

[API](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4.md) · [All operations](https://skmtc.net/qonversion/apis/qonversion-rest-api-v4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/qonversion/qonversion-rest-api-v4/versions/e3f72cf8951c/schema)