---
title: "Create Label"
method: POST
path: "/labels"
tags: ["Label Requests"]
---

# Create Label

`POST /labels`

Create a label for a label request.

#### Required API key scopes
- Labels (Write)

## Request body

- union
  - object
    - `label_request_id` integer, required — The label request id this label applies to.
    - `tracking_number` string, required — The tracking number associated with the label.
    - `tracking_url` string, nullable — The tracking URL associated with the label.
    - `carrier` string, required — The carrier associated with the label.
    - `label_url` string, nullable, required — The URL containing the printable PDF of the labels. Required unless `qrcode_url` is provided.
    - `qrcode_url` string, nullable — The QR Code URL containing the printable PDF of the labels.
    - `rate` MoneySetData, required
      - `amount` integer, required — The amount represented in cents.
      - `currency_code` string, required — The 3 character (ISO 4217) currency code.
  - object
    - `label_request_id` integer, required — The label request id this label applies to.
    - `tracking_number` string, required — The tracking number associated with the label.
    - `tracking_url` string, nullable — The tracking URL associated with the label.
    - `carrier` string, required — The carrier associated with the label.
    - `label_url` string, nullable — The URL containing the printable PDF of the labels. Required unless `qrcode_url` is provided.
    - `qrcode_url` string, nullable, required — The QR Code URL containing the printable PDF of the labels.
    - `rate` MoneySetData, required
      - `amount` integer, required — The amount represented in cents.
      - `currency_code` string, required — The 3 character (ISO 4217) currency code.

## Response `201`

Created

- LabelResponse
  - `id` integer, required — The id of the label you created.
  - `tracking_number` string, required — The tracking number associated with the label.
  - `tracking_url` string, nullable — The tracking URL associated with the label.
  - `carrier` string, required — The carrier associated with the label.
  - `label_url` string, nullable — The URL containing the printable PDF of the labels.
  - `qrcode_url` string, nullable — The QR Code URL containing the printable PDF of the labels.
  - `rate` MoneySetData, required
    - `amount` integer, required — The amount represented in cents.
    - `currency_code` string, required — The 3 character (ISO 4217) currency code.
  - `status` 'queueable' | 'queued' | 'queued_for_purchase' | 'purchase_failed' | 'new' | 'pre_transit' | 'in_transit' | 'out_for_delivery' | 'delivered' | 'available_for_pickup' | 'cancelled' | 'unknown' | 'return_to_sender' | 'failure' | 'error' | 'refund_requested', required — The current status of the label.
  - `created_at` string, date-time, required

## Other responses

- `401` — Unauthorized
- `404` — The associated label request could not be found.
- `422` — Unprocessable
- `500` — An unexpected error occurred while creating the label.

---

[API](https://skmtc.dev/loopreturns/apis/listings-api.md) · [All operations](https://skmtc.dev/loopreturns/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loopreturns/listings-api/revisions/750e6012dbb8/schema)