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).

Not yet available to API tokens

This endpoint currently requires session authentication; Personal Access Token scope support is in progress.

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), label_print_id (the audit-trail record), and invalid_mskus (array of strings, normally empty — see below).

Partial success — invalid_mskus: Amazon rejects an entire label batch when it does not recognise even one of the MSKUs in it. Rather than failing the whole request, any MSKU Amazon names as unrecognised is dropped and the remaining MSKUs are labelled. The dropped MSKUs are returned in invalid_mskus and are not present in the label document, nor counted in the recorded print quantity. An unrecognised MSKU usually means the listing is inactive, was changed very recently (e.g. switched to FNSKU labelling), or does not exist on the seller account for the destination marketplace.

Marketplace: labels are requested against the marketplace matching the destination warehouse's country, falling back to the first participating marketplace when that country is not one the seller participates in.

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 recognises none of the submitted MSKUs, so there is nothing left to label
  • Amazon rejects the request for another reason (SP-API error messages are parsed and surfaced per field)
  • Amazon does not return a label document

Request​

Responses​

OK

Response Headers
    Content-Type