---
title: "Create Medication"
method: POST
path: "/medications"
tags: ["provider", "medications"]
---

# Create Medication

`POST /medications`

Create a new medication with optional template.

## Headers

- `TENANT` string, required
- `API-KEY` string, required

## Request body

- MedicationCreate — Schema for creating a medication product (inherits from Item).
  - `name` string, required
  - `unit` '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'
  - `brandName` string, nullable
  - `description` string, nullable
  - `price` integer
  - `category` string, nullable
  - `internalNotes` string, nullable
  - `sortOrder` integer, nullable
  - `taxable` boolean
  - `allowCustomPricing` boolean
  - `isUsedAsTemplate` boolean
  - `templateAmount` number, nullable
  - `templateAdministrationLocation` string, nullable
  - `templateFrequency` string, nullable
  - `templateQuantity` number, nullable
  - `templateComment` string, nullable
  - `templateLotNumber` string, nullable

## Response `200`

Successful Response

- MedicationSummary — Schema for returning medication product information.
  - `name` string, required
  - `unit` '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'
  - `brandName` string, nullable
  - `description` string, nullable
  - `price` integer
  - `category` string, nullable
  - `internalNotes` string, nullable
  - `sortOrder` integer, nullable
  - `taxable` boolean, required
  - `allowCustomPricing` boolean, required
  - `isUsedAsTemplate` boolean
  - `templateAmount` number, nullable
  - `templateAdministrationLocation` string, nullable
  - `templateFrequency` string, nullable
  - `templateQuantity` number, nullable
  - `templateComment` string, nullable
  - `templateLotNumber` string, nullable
  - `id` string, required
  - `createdDate` string, date-time, required
  - `updatedDate` string, date-time, nullable
  - `isPhysical` boolean, required
  - `isArchived` boolean, required
  - `template` MedicationTemplateSummary — Schema for returning medication template information.
    - `name` string, required
    - `amount` number, nullable
    - `unit` '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'
    - `administrationLocation` string, nullable
    - `frequency` string, nullable
    - `quantity` number
    - `comment` string, nullable
    - `lotNumber` string, nullable
    - `id` string, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/decodahealth/apis/decoda-api.md) · [All operations](https://skmtc.dev/decodahealth/apis/decoda-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/decodahealth/decoda-api/revisions/4939a65a89d2/schema)