API Documentation
- Admin Api Keys
- Admin Campaigns
- Admin Claims
- Admin Collections
- Admin Currencies
- Admin Customer Groups
- Admin Customers
- Admin Draft Orders
- Admin Exchanges
- Admin Fulfillment Providers
- Admin Fulfillment Sets
- Admin Fulfillments
- Admin Gift Cards
- Admin Inventory Items
- GETList Inventory Items
- POSTCreate Inventory Item
- POSTManage Inventory Levels
- GETGet a Inventory Item
- POSTUpdate an Inventory Item
- DELDelete Inventory Item
- GETList Inventory Levels
- POSTCreate Inventory Level for Inventory Item
- POSTManage Inventory Levels of Inventory Item
- POSTUpdate an Inventory Level of an Inventory Item
- DELRemove Inventory Level of Inventory Item
- GET
- Admin Invites
- Admin Notifications
- Admin Order Edits
- Admin Orders
- Admin Payment Collections
- Admin Payments
- Admin Plugins
- Admin Price Lists
- Admin Price Preferences
- Admin Product Categories
- Admin Product Tags
- Admin Product Types
- Admin Product Variants
- Admin Products
- Admin Promotions
- Admin Refund Reasons
- Admin Regions
- Admin Reservations
- Admin Return Reasons
- Admin Returns
- Admin Sales Channels
- Admin Shipping Options
- Admin Shipping Profiles
- Admin Stock Locations
- Admin Store Credit Accounts
- Admin Stores
- Admin Tax Providers
- Admin Tax Rates
- Admin Tax Regions
- Admin Transaction Groups
- Admin Uploads
- Admin Users
- Admin Workflows Executions
- Store Auth
- Admin Auth
- Store Carts
- Store Collections
- Store Currencies
- Store Customers
- Store Gift Cards
- Store Orders
- Store Payment Collections
- Store Payment Providers
- Store Product Categories
- Store Product Tags
- Store Product Types
- Store Products
- Store Regions
- Store Return Reasons
- Store
- Store Shipping Options
- Store Store Credit Accounts
- Admin Algolia
- Admin Attributes
- Admin Commission
- Admin Configuration
- Admin Order Sets
- Admin Requests
- Admin Return Request
- Admin Reviews
- Admin Sellers
- Auth
- Store Return Request
- Store Reviews
- Store Sellers
- Store Wishlist
- Vendor Attributes
- Vendor Campaigns
- Vendor Commission
- Vendor Configuration
- Vendor Customer Groups
- Vendor Customers
- Vendor Fulfillment Providers
- Vendor Fulfillment Sets
- Vendor Inventory Items
- Vendor Invites
- Vendor Current Member
- Vendor Members
- Vendor Notifications
- Vendor Orders
- Vendor Payout Account
- Vendor Payouts
- Vendor Price Lists
- Vendor Price Preferences
- Vendor Product Categories
- Vendor Product Collections
- Vendor Product Tags
- Vendor Product Types
- Vendor Products
- Vendor Promotions
- Vendor Regions
- Vendor Requests
- Vendor Reservations
- Vendor Return Requests
- Vendor Returns
- Vendor Sales Channels
- Vendor Sellers
- Vendor Onboarding
- Vendor Reviews
- Vendor Shipping Options
- Vendor Shipping Profiles
- Vendor Statistics
- Vendor Stock Locations
- Vendor Stores
Admin Inventory Items
Create Inventory Item
Create an inventory item.
POST
/
admin
/
inventory-items
Copy
import Medusa from "@medusajs/js-sdk"
export const sdk = new Medusa({
baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
debug: import.meta.env.DEV,
auth: {
type: "session",
},
})
sdk.admin.inventoryItem.create({
sku: "SHIRT"
})
.then(({ inventory_item }) => {
console.log(inventory_item)
})
Copy
{
"inventory_item": {
"id": "<string>",
"sku": "<string>",
"origin_country": "<string>",
"hs_code": "<string>",
"requires_shipping": true,
"mid_code": "<string>",
"material": "<string>",
"weight": 123,
"length": 123,
"height": 123,
"width": 123,
"title": "<string>",
"description": "<string>",
"thumbnail": "<string>",
"metadata": {},
"location_levels": [
{
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"inventory_item_id": "<string>",
"location_id": "<string>",
"stocked_quantity": 123,
"reserved_quantity": 123,
"incoming_quantity": 123,
"metadata": {},
"inventory_item": {},
"available_quantity": 123
}
]
}
}
Authorizations
Bearer authentication header of the form Bearer <token>
, where <token>
is your auth token.
Query Parameters
Comma-separated fields that should be included in the returned data. if a field is prefixed with +
it will be added to the default fields, using -
will remove it from the default fields. without prefix it will replace the entire default fields.
Body
application/json
The inventory item's details.
Response
200
application/json
OK
The inventory item's details.
Copy
import Medusa from "@medusajs/js-sdk"
export const sdk = new Medusa({
baseUrl: import.meta.env.VITE_BACKEND_URL || "/",
debug: import.meta.env.DEV,
auth: {
type: "session",
},
})
sdk.admin.inventoryItem.create({
sku: "SHIRT"
})
.then(({ inventory_item }) => {
console.log(inventory_item)
})
Copy
{
"inventory_item": {
"id": "<string>",
"sku": "<string>",
"origin_country": "<string>",
"hs_code": "<string>",
"requires_shipping": true,
"mid_code": "<string>",
"material": "<string>",
"weight": 123,
"length": 123,
"height": 123,
"width": 123,
"title": "<string>",
"description": "<string>",
"thumbnail": "<string>",
"metadata": {},
"location_levels": [
{
"id": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"deleted_at": "2023-11-07T05:31:56Z",
"inventory_item_id": "<string>",
"location_id": "<string>",
"stocked_quantity": 123,
"reserved_quantity": 123,
"incoming_quantity": 123,
"metadata": {},
"inventory_item": {},
"available_quantity": 123
}
]
}
}
Assistant
Responses are generated using AI and may contain mistakes.