---
title: "Create Label Template"
method: POST
path: "/v1/label-templates"
tags: ["Label Templates"]
---

# Create Label Template

`POST /v1/label-templates`

## Request

- Base URL: `/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/api/v1/label-templates`
- Auth: API key in header `Authorization`

## Request body

- RepoLabelTemplateCreate
  - `canvasData` object
  - `description` string
  - `dpi` integer
  - `height` number, required
  - `isShared` boolean
  - `name` string, required
  - `offsetX` number
  - `offsetY` number
  - `outputFormat` 'png' | 'pdf'
  - `preset` string, nullable
  - `sheetLayout` LabelmakerSheetLayout
    - `columns` integer: Number of labels across
    - `gutterH` number: Horizontal gap between labels in mm
    - `gutterV` number: Vertical gap between labels in mm
    - `marginLeft` number: Left margin in mm
    - `marginTop` number: Top margin in mm
    - `pageHeight` number: Sheet height in mm (e.g., 279.4 for Letter, 297 for A4)
    - `pageWidth` number: Sheet width in mm (e.g., 215.9 for Letter, 210 for A4)
    - `rows` integer: Number of labels down
  - `width` number, required

## Response `201`

Created

- RepoLabelTemplateOut
  - `canvasData` object
  - `createdAt` string
  - `description` string
  - `dpi` integer
  - `height` number
  - `id` string
  - `isOwner` boolean
  - `isShared` boolean
  - `name` string
  - `offsetX` number
  - `offsetY` number
  - `outputFormat` string
  - `ownerId` string
  - `preset` string
  - `sheetLayout` LabelmakerSheetLayout
    - `columns` integer: Number of labels across
    - `gutterH` number: Horizontal gap between labels in mm
    - `gutterV` number: Vertical gap between labels in mm
    - `marginLeft` number: Left margin in mm
    - `marginTop` number: Top margin in mm
    - `pageHeight` number: Sheet height in mm (e.g., 279.4 for Letter, 297 for A4)
    - `pageWidth` number: Sheet width in mm (e.g., 215.9 for Letter, 210 for A4)
    - `rows` integer: Number of labels down
  - `updatedAt` string
  - `width` number

## Changes

- **2026-10-31** `c75bd57db3c6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sysadminsmedia/apis/homebox-api/changes/v1/label-templates/post.md)

---

[API](https://skmtc.dev/sysadminsmedia/apis/homebox-api.md) - [All operations](https://skmtc.dev/sysadminsmedia/apis/homebox-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sysadminsmedia/apis/homebox-api/revisions/316b3e623d70?raw)