---
title: "Create"
method: POST
path: "/v1/workbooks/{workbookId}/flags"
tags: ["flags"]
---

# Create

`POST /v1/workbooks/{workbookId}/flags`

Creates a new flag for the workbook

## Path parameters

- `workbookId` string, required — Workbook ID

## Headers

- `Authorization` string, required
- `X-Disable-Hooks` 'true', required

## Request body

- TypeFlagsCreateFlagRequest — Request to create a new flag
  - `slug` string, required — The unique identifier for the flag
  - `label` string, required — The human-readable name for the flag
  - `colorHex` string, required — The hex color code for the flag (e.g., "#0090FF")

## Response `200`

Response with status 200

- TypeFlagsFlagResponse — A flag object
  - `id` string, required — The unique identifier for the flag
  - `slug` string, required — The flag slug
  - `label` string, required — The flag label
  - `colorHex` string, required — The hex color code for the flag
  - `workbookId` string, required — Workbook ID
  - `createdAt` string, date-time, required — When the flag was created
  - `updatedAt` string, date-time, required — When the flag was last updated

---

[API](https://skmtc.net/flatfile/apis/api-reference.md) · [All operations](https://skmtc.net/flatfile/apis/api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/flatfile/api-reference/versions/9d3a9979cd96/schema)