---
title: "Create new feature toggle"
method: POST
path: "/v2/features"
tags: ["Feature Toggle Service"]
---

# Create new feature toggle

`POST /v2/features`

## Request

- Base URL: `https://app.metricool.com/api`
- URL: `https://app.metricool.com/api/v2/features`
- Auth: none declared

Creates a new feature toggle. Admin access required.

## Request body

- CreateFeatureToggleRequest: Request to create a new feature toggle
  - `name` string, required: Feature name
  - `description` string: Feature description
  - `enabled` boolean, required: Whether feature is enabled
  - `strategy` 'all_users' | 'role_based' | 'whitelist' | 'beta_users' | 'segmented', required: Strategy for applying feature
  - `segments` integer: Number of segments for segmented strategy

## Response `200`

Feature toggle created successfully

- JsonOkResponseFeatureToggleDto
  - `metadata` object
  - `page` JsonPaging
    - `next` string
  - `data` FeatureToggleDto: Feature toggle configuration
    - `id` integer: Feature toggle ID
    - `name` string, required: Feature name
    - `description` string: Feature description
    - `enabled` boolean, required: Whether feature is enabled
    - `strategy` 'all_users' | 'role_based' | 'whitelist' | 'beta_users' | 'segmented', required: Strategy for applying feature
    - `segments` integer: Number of segments for segmented strategy
    - `whitelistCount` integer: Number of users in whitelist (only for WHITELIST strategy)

## Other responses

- `400`: Bad request - Invalid input
- `401`: Unauthorized
- `403`: Forbidden - Admin access required
- `409`: Conflict - Feature name already exists

---

[API](https://skmtc.dev/metricool/apis/metricool-api.md) · [All operations](https://skmtc.dev/metricool/apis/metricool-api/llms.txt) · [OpenAPI document](https://skmtc.dev/metricool/apis/metricool-api/revisions/b51dcfc02f38?raw)