---
title: "Create a label"
method: POST
path: "/v4/labels"
tags: ["Labels"]
---

# Create a label

`POST /v4/labels`

## Request body

- CreateLabelRequest
  - `name` string, required
  - `cssClassId` string, nullable

## Response `201`

The new label

- LabelResponse
  - `labelId` string, nullable
  - `name` string, nullable
  - `backgroundColor` string, nullable
  - `foregroundColor` string, nullable
  - `intLabelID` integer
  - `createdOn` string, date-time, nullable
  - `createdBy` string, nullable
  - `active` boolean
  - `count` integer, nullable
  - `archivedCount` integer, nullable
  - `orderVal` integer, nullable

## Other responses

- `400` — Invalid request
- `403` — Insufficient permissions

---

[API](https://skmtc.net/submittable/apis/submittable-api-documentation.md) · [All operations](https://skmtc.net/submittable/apis/submittable-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/submittable/submittable-api-documentation/revisions/254ce50c8212/schema)