---
title: "Create Dose"
method: POST
path: "/user/patient/doses"
tags: ["provider", "user", "doses"]
---

# Create Dose

`POST /user/patient/doses`

Create a new dose record (medication administration).

## Headers

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

## Request body

- MedicationWithDoseCreate — Schema for creating a medication administration when the medication product may not exist.
  - `name` string, required
  - `unit` string, nullable
  - `patientId` string, required
  - `providerId` string, nullable
  - `doseDate` string, date-time, nullable
  - `sideEffects` string, nullable
  - `administrationLocation` string, nullable
  - `amount` number, nullable
  - `quantity` number
  - `frequency` string, nullable
  - `comment` string, nullable
  - `lotNumber` string, nullable
  - `stockId` string, nullable
  - `noteId` string, nullable
  - `signedOffProviderId` string, nullable
  - `signedOffDate` string, date-time, nullable
  - `isUsedAsTemplate` boolean

## Response `200`

Successful Response

- DoseSummary — Schema for returning dose information with computed fields.
  - `medicationId` string, required
  - `patientId` string, required
  - `providerId` string, nullable
  - `doseDate` string, date-time, nullable
  - `name` string, nullable
  - `unit` string, nullable
  - `sideEffects` string, nullable
  - `administrationLocation` string, nullable
  - `amount` number, nullable
  - `quantity` number
  - `frequency` string, nullable
  - `comment` string, nullable
  - `lotNumber` string, nullable
  - `stockId` string, nullable
  - `noteId` string, nullable
  - `signedOffProviderId` string, nullable
  - `signedOffDate` string, date-time, nullable
  - `isArchived` boolean
  - `id` string, required
  - `createdDate` string, date-time, required
  - `updatedDate` string, date-time, nullable
  - `provider` UserTiny
    - `id` string, required — The unique identifier for the user.
    - `firstName` string, nullable — The user's first name.
    - `lastName` string, nullable — The user's last name.
    - `phoneNumber` string, nullable — The user's phone number.
    - `email` string, nullable — The user's email address.
    - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
    - `locationId` string, nullable — The location of the user.
  - `signedOffProvider` UserTiny
    - `id` string, required — The unique identifier for the user.
    - `firstName` string, nullable — The user's first name.
    - `lastName` string, nullable — The user's last name.
    - `phoneNumber` string, nullable — The user's phone number.
    - `email` string, nullable — The user's email address.
    - `type` 'PROVIDER' | 'PATIENT' | 'ASSISTANT', required
    - `locationId` string, nullable — The location of the user.

## 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)