The Item Object

category_id

Item category must be mapped to a valid ThredUp category ID, which can be retrieved using the Get Categories endpoint.

Note

Only leaf nodes (i.e., categories at the third level of the hierarchy) represent actual assignable categories. Parent nodes above them serve only as category groups and cannot be used for item classification.

brand_id

Brand ID of the item has to be found in the response of the Get Brands endpoint by searching for a desired brand name.

warehouse_id

The partner must provide a list of warehouses that will be used for delivery and each of them will receive an ID. The ID should be specified in the listing request which will ThredUp know where the item is, which taxes are applicable, etc.

Note

Warehouses are created as part of the onboarding process and are not created via the API.

photos

The API accepts URLs to photos, so photos should be uploaded somewhere prior to listing. Photos should be matched with the available subtypes: for example, front subtype should be the frontal photo etc. The more photos are provided in a listing request, the better.

Note

An item must have a photo of front subtype in order to be listed. If this is not provided, the item will not be listed.

Note

The URLs to photos must be valid regardless of the environment. If photos cannot be downloaded, then the item will not be listed.

size

Size has to be mapped to the sizes available for the item category. Allowed sizes are returned in the Get Categories response in the root category group, the parent name is the scale (e.g. S-M-L) and all of the names in the array are available sizes (e.g. XXS, XS, S).

Note

Not all categories support all sizes: for example, all handbags are one sized (Fits All).

Note

If the selected category includes a default size, the size field can be omitted when creating the item, unless a different size is required.

external_id

If there’s a need to prevent listing of duplicate items, an external id field can be specified and the API will verify that no other item with the provided external id is listed.

price

Note

There are rounding rules for item prices that are applied when items are listed, which usually means that the actual price of an item on ThredUP will be a slightly higher than the price provided by the partner.

For example, if an item costs \$11.00 the price will be \$11.99. Please reach out to receive the full list of rounding rules.

discount

If the partner wants an item to participate in ThredUP sales, a max percentage can be specified for the item and that will mean that the discount cannot be higher than the specified percentage.

Note

Items with a discount percentage greater than 0 will be included in ThredUP sales.

By default items are excluded from any sales.

attributes

None of the attributes are required, but we highly recommend them to be provided because they impact the discoverability of items.

Note

All measurements are in inches.