---
title: "Creating Journal Entries"
canonical: "https://wiki.patientsknowbest.com/space/api/5084053505/Creating%20Journal%20Entries"
format: markdown
---
> Macro (toc)

# How

1. Assign the <u>[Observation resource](https://hl7.org/fhir/R4/observation.html)</u> a **[logical id](https://wiki.hub.patientsknowbest.com/wiki/spaces/api/pages/5003673621)****.**
2. Reference the logical ID of a previously created Patient resource in the **subject** field of the Observation.
3. **Status** must be included.  See the FHIR R4 spec for the <u>[status value set](https://hl7.org/fhir/R4/valueset-observation-status.html)</u>.
4. **Category** must be included and should use the “DIARYENTRY” code with the PKB system of: "[http://fhir.patientsknowbest.com/codesystem/observation-category](http://fhir.patientsknowbest.com/codesystem/observation-category) ".
5. **Code** should be the journal entry’s “subject” or title of the entry.
6. The journal entry’s main content should be sent in **Observation.value.**
7. **Observation.effectiveDateTime** should be used as the date of the journal entry.
8. Use an extension to reference an attached document.
9. POST https://{client}<u>.fhir-api.sandbox.patientsknowbest.com/fhir/Observation</u>

## Journal Entry Example

```
{
  "resourceType": "Observation",
  "status": "final",
  "category": [
    {
      "coding": [
        {
          "system": "http://fhir.patientsknowbest.com/codesystem/observation-category",
          "code": "DIARYENTRY",
          "display": "Journal Entry"
        }
      ]
    }
  ],
  "code": {
    "text": "Rash appears"
  },
  "subject": {
    "reference": "Patient/4aaa8eac-ee90-20ab-27ba-a94bb9b7eef5"
  },
  "effectiveDateTime": "2025-10-27T09:47:00+00:00",
  "valueString": "A rash appears on my forearm after taking the medicine."
  }
```