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

# Create a label

`POST /labels`

## Request

- Base URL: `https://api.streamtime.net/v2`
- URL: `https://api.streamtime.net/v2/labels`
- Auth: HTTP bearer

Creates a new label for an entity. Optionally creates a master label.

## Query parameters

- `create_master_label` boolean

## Request body

- Label: A label that can be attached to an entity
  - `id` integer: Label ID
  - `name` string: Label name
  - `entityId` integer: ID of the entity this label is attached to
  - `labelType` LabelType: What the label will be attached to.
    - `id` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Label type ID (1=Job, 2=Quote, 3=Invoice, 4=Logged Expense, 5=Company, 6=Contact, 7=User, 8=Job Group)
    - `name` string

## Response `200`

Label created successfully.

- Label: A label that can be attached to an entity
  - `id` integer: Label ID
  - `name` string: Label name
  - `entityId` integer: ID of the entity this label is attached to
  - `labelType` LabelType: What the label will be attached to.
    - `id` 1 | 2 | 3 | 4 | 5 | 6 | 7 | 8: Label type ID (1=Job, 2=Quote, 3=Invoice, 4=Logged Expense, 5=Company, 6=Contact, 7=User, 8=Job Group)
    - `name` string

---

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