POST
Create a stock label
Company space For: Stock keeper, Manager · Permission: stock_labels.create Conditions
  • The company must hold the stock label management feature.
  • name is required, up to 100 characters.
  • The name must be unique inside the organization, compared ignoring case (Promo and promo collide).
What else happens
  • The label is created for the whole organization (shared catalogue); the creating company is stored for traceability only and is never updated.
Part of Check stock levels and label lots.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

response
enum<string>
default:none

Response mode. Default none; none answers 204 No Content.

Available options:
none,
resource
fields
string

Comma-separated JSON keys of the root resource (id is always rendered). Available: id, name, created_at, updated_at.

include
string

Comma-separated include paths, each optionally followed by its fields in parentheses: units(id,sku),units.uomUnit(id,name). Max depth 6, max 40 paths. Available: .

Body

application/json
name
string
required

Name of the new label, up to 100 characters. Required. Must be unique in the organization, ignoring case.

Maximum string length: 100

Response

Resource (only with response=resource).

id

Identifier of the stock label (27-character KSUID string).

name

Name of the label, unique in the organization ignoring case.

created_at

Date and time the record was created (ISO 8601, UTC).

updated_at

Date and time the record was last changed (ISO 8601, UTC).