Skip to main content
POST
/
inventory
/
items
/
create
Create Item
curl --request POST \
  --url https://api.decodahealth.com/inventory/items/create \
  --header 'API-KEY: <api-key>' \
  --header 'Content-Type: application/json' \
  --header 'TENANT: <tenant>' \
  --data '
{
  "name": "<string>",
  "price": 123,
  "id": "<string>",
  "brandName": "<string>",
  "description": "<string>",
  "category": "<string>",
  "unit": "AMPOULES",
  "isPhysical": true,
  "isArchived": false,
  "internalNotes": "<string>",
  "taxable": false,
  "sortOrder": 123,
  "allowCustomPricing": false,
  "type": "PRODUCT",
  "stocks": [
    {
      "itemId": "<string>",
      "stockId": "<string>",
      "quantityUsed": 123
    }
  ]
}
'
{
  "name": "<string>",
  "price": 123,
  "usageCount": 123,
  "id": "<string>",
  "brandName": "<string>",
  "description": "<string>",
  "category": "<string>",
  "unit": "AMPOULES",
  "isPhysical": true,
  "isArchived": false,
  "internalNotes": "<string>",
  "taxable": false,
  "sortOrder": 123,
  "allowCustomPricing": false,
  "type": "PRODUCT",
  "stocks": [
    {
      "itemId": "<string>",
      "stockId": "<string>",
      "quantityUsed": 123,
      "stock": {
        "name": "<string>",
        "unit": "AMPOULES",
        "id": "<string>",
        "description": "<string>",
        "notes": "<string>",
        "category": "<string>",
        "isArchived": false,
        "shipments": [
          {
            "stockId": "<string>",
            "supplierId": "<string>",
            "locationId": "<string>",
            "quantity": 123,
            "remainingQuantity": 123,
            "locationName": "<string>",
            "id": "<string>",
            "lotNumber": "<string>",
            "expiryDate": "2023-11-07T05:31:56Z",
            "sku": "<string>",
            "cost": 123,
            "supplier": {
              "name": "<string>",
              "id": "<string>",
              "description": "<string>",
              "website": "<string>",
              "email": "<string>",
              "preferredContactMethod": "<string>",
              "phoneNumber": "<string>",
              "addressLineOne": "<string>",
              "addressLineTwo": "<string>",
              "city": "<string>",
              "state": "<string>",
              "zipCode": "<string>",
              "country": "<string>",
              "isArchived": false
            },
            "createdDate": "2023-11-07T05:31:56Z",
            "note": "<string>"
          }
        ]
      }
    }
  ]
}

Headers

TENANT
string
required

The tenant you are making this request on behalf of

API-KEY
string
required

Your api key

Body

application/json
name
string
required

Name of the item

price
integer
required

Price of the item in cents

id
string

Unique identifier for the item

brandName
string | null

Optional brand name of the item

description
string | null

Optional description of the item

category
string | null

Category name (references category.name)

unit
enum<string> | null

Unit of measurement for the item

Available options:
AMPOULES,
APPLICATORS,
BOTTLES,
BOXES,
CAPSULES,
CUPS,
DOSES,
G_PER_ML,
GRAMS,
IU,
IU_PER_ML,
OUNCES,
FLUID_OUNCES,
KG,
KITS,
LITERS,
MCG,
MG,
MG_PER_ML,
ML,
MMOL,
MICROGRAM_PER_ML,
PACKS,
PAIRS,
PATCHES,
PERCENTAGE,
PIECES,
POUCHES,
ROLLS,
SACHETS,
SHEETS,
SPRAYS,
STRIPS,
SYRINGES,
TABLETS,
TABLETS_PER_DAY,
TESTS,
TUBES,
UNITS,
VIALS,
TREATMENTS,
SESSIONS,
PULSES,
JOULES,
CENTIMETERS,
THREAD_COUNT,
INJECTIONS,
WRINKLE_UNITS,
POUNDS,
FEET,
INCHES
isPhysical
boolean
default:true

Whether the item is physical

isArchived
boolean
default:false

Whether the item is archived

internalNotes
string | null

Optional internal notes for the item

taxable
boolean
default:false

Whether the item is subject to taxes

sortOrder
integer | null

Optional sort order for the item

allowCustomPricing
boolean
default:false

Whether custom pricing is allowed for this item

type
enum<string>
default:PRODUCT

Type of item (PRODUCT, MEDICATION, etc.)

Available options:
ITEM,
PRODUCT,
MEDICATION,
SERVICE,
PACKAGE,
MEMBERSHIP
stocks
ItemStock · object[] | null

Optional linked stocks for the item

Response

Successful Response

name
string
required

Name of the item

price
integer
required

Price of the item in cents

usageCount
integer | null
required

Number of times this item has been used

id
string

Unique identifier for the item

brandName
string | null

Optional brand name of the item

description
string | null

Optional description of the item

category
string | null

Category name (references category.name)

unit
enum<string> | null

Unit of measurement for the item

Available options:
AMPOULES,
APPLICATORS,
BOTTLES,
BOXES,
CAPSULES,
CUPS,
DOSES,
G_PER_ML,
GRAMS,
IU,
IU_PER_ML,
OUNCES,
FLUID_OUNCES,
KG,
KITS,
LITERS,
MCG,
MG,
MG_PER_ML,
ML,
MMOL,
MICROGRAM_PER_ML,
PACKS,
PAIRS,
PATCHES,
PERCENTAGE,
PIECES,
POUCHES,
ROLLS,
SACHETS,
SHEETS,
SPRAYS,
STRIPS,
SYRINGES,
TABLETS,
TABLETS_PER_DAY,
TESTS,
TUBES,
UNITS,
VIALS,
TREATMENTS,
SESSIONS,
PULSES,
JOULES,
CENTIMETERS,
THREAD_COUNT,
INJECTIONS,
WRINKLE_UNITS,
POUNDS,
FEET,
INCHES
isPhysical
boolean
default:true

Whether the item is physical

isArchived
boolean
default:false

Whether the item is archived

internalNotes
string | null

Optional internal notes for the item

taxable
boolean
default:false

Whether the item is subject to taxes

sortOrder
integer | null

Optional sort order for the item

allowCustomPricing
boolean
default:false

Whether custom pricing is allowed for this item

type
enum<string>
default:PRODUCT

Type of item (PRODUCT, MEDICATION, etc.)

Available options:
ITEM,
PRODUCT,
MEDICATION,
SERVICE,
PACKAGE,
MEMBERSHIP
stocks
ItemStockDetail · object[] | null

Optional linked stocks for the item