Skip to main content

Create Item Labels (FNSKU)

POST 

/api/amazon/:integrationInstance/draft-inbound-plans/:draft_inbound_plan/labels/item-labels

Generate FNSKU (MSKU) item labels for products on the draft inbound plan via the synchronous Amazon FBA Inbound v2024-03-20 createMarketplaceItemLabels operation. Returns the label document download URL immediately (no tracked job) and records the print in the label-print audit trail (see List Label Prints; repeat prints are auto-flagged is_reprint).

Authorization

Any valid API token can call this endpoint — no specific scope required. Manage tokens.

Fields:

  • label_type (string, required) — STANDARD_FORMAT or THERMAL_PRINTING
  • page_type (string, required, max 64) — Amazon label page type, e.g. Letter_30 (30-up letter sheet), Letter_24, Thermal_NonPCP. Pair thermal page types with THERMAL_PRINTING
  • mskus (array, required, min 1) — the MSKUs to print labels for:
    • mskus.*.msku (string, required, max 255) — must be an MSKU that is part of this inbound plan (422 otherwise)
    • mskus.*.quantity (integer, required, min 1) — number of labels for this MSKU

Response: url (time-limited label document download URL), expiration (URL expiration timestamp, may be null), and label_print_id (the audit-trail record).

422 conditions:

  • an mskus.*.msku value is not part of this inbound plan
  • the integration instance has no participating Amazon marketplace (re-sync marketplace participations)
  • Amazon rejects the request (SP-API error messages are parsed and surfaced per field)
  • Amazon does not return a label document

Request

Responses

OK

Response Headers
    Content-Type