Create a new listing for the authenticated seller.
Use this endpoint for single listing creation when you already know the target item URN and listing attributes.
Authentication and ownership:
Input validation:
urn must resolve to an existing catalog item.gradingProvider, gradingScore, and gradingNumber must be supplied together or omitted together.notes is optional, normalized by the API, and limited to 255 characters.reference is optional seller/integration metadata, normalized by the API, and limited to 255 characters.reference values are treated as a clear request (null in storage).Listing validity rules:
>= 2000 (lowest-denomination integer) require an attachment photo.valid: false and becomes valid after a qualifying attachment is finalized.Side effects:
LISTING_CREATED to seller webhooks.Returns the complete listing resource with seller, item, attachment metadata, and the normalized reference value.
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Data required to create a listing
Product condition
Price in pence
Languages of the card
URN of the product being listed
Total quantity for this listings
Variants of the listed card
Seller's comment about the listing
Provider responsible for grading the card
Score assigned to the card by the grading provider
Certificate or registration number issued by the grading provider
True when the listing is hidden from buyers
Private notes for the seller such as SKUs or storage locations
255Third-party integration reference for this listing
255Listing created
Product condition
Price in pence
Languages of the card
Timestamp when the listing was created
Timestamp when the listing was last updated
Details of the item being listed
Seller of the listing
True when the listing has active item holds
True when the listing meets all requirements
True when the listing is hidden from buyers
Total quantity for this listings
Total available for this listing
Variants of the listed card
Seller's comment about the listing
Provider responsible for grading the card
Score assigned to the card by the grading provider
Certificate or registration number issued by the grading provider
Image attachments for the listing
Private notes for the seller such as SKUs or storage locations
255Third-party integration reference for this listing
255