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

> Macro (excerpt)
> 
> # How
> 
> 1. When you send the [Immunization resource](https://hl7.org/fhir/R4/immunization.html), you will assign it 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 **patient reference** field of the Immunization resource.
> 3. A **status** must be included.  See the FHIR R4 spec for the [status value set](https://hl7.org/fhir/R4/valueset-immunization-status.html).
> 4. A **vaccineCode** must be included.  Using a SNOMED CT code is preferred.
> 5. Include any other information in the Immunization, using coding when possible.
> 6. POST https://<client><u>.fhir-api.sandbox.patientsknowbest.com/fhir/Immunization</u>

> Macro (excerpt)
> 
> Very basic Immunization resource example:
> 
> ```
> {
>  "patient": {
>   "reference": "Patient/f4bd895b-0dbf-49d2-8130-4cb52679972d"
>  },
>  "vaccineCode": {
>   "coding": [
>    {
>     "code": "310551000000106",
>     "system": "http://snomed.info/sct",
>     "display": "Booster diphtheria tetanus and five component acellular pertussis, haemophilus influenzae type b, inactivated polio vaccination (procedure)"
>    }
>   ]
>  },
>  "resourceType": "Immunization",
>  "status": "completed",
>  "id": "A828B85E-42B2-3C9A-4B4F-E02AECEDB5B3",
>  "occurrenceDateTime": "1991-09-07T12:23:00+01:00",
>  "performer": [
>   {
>    "actor": {
>     "display": "Mr PKB Test",
>     "reference": "Practitioner/66ce7f63-fb10-4afe-91cf-b10a0424f3e0"
>    }
>   }
>  ],
>  "text": {
>   "div": "<div xmlns=\"http://www.w3.org/1999/xhtml\">Booster diphtheria tetanus and five component acellular pertussis, haemophilus influenzae type b, inactivated polio vaccination (procedure)</div>",
>   "status": "generated"
>  }
> }
> ```