Skip to content

Howto create a patient


A patient in EHR.Network is a person with an EHR. So the terms are used interchangeably in our documentation.

You have to create a patient before data can be added to their EHR. This document explains the process of creating a patient.


By default, users on EHR.Network do not have an EHR. So you will not be able to record clinical data for users.

Once you are logged into an organization, creating a patient involves registering the person and mapping his/her personUuid to the organization. This will make the patient visible to the users in the organization and also allow the users to work with them.

The mindmap below illustrates the process of creating a person along with the available options and the internal actions that the platform managed automatically.

Create person


On registering a new patient an EHR is also created for them automatically in our CDR. However a patient is always identified using personUuid and ehrId is never exposed outside the platform for data security and privacy.


  1. Call POST /person api to create a person. You can pass only the mandatory data for quick create
  2. On success this returns the personUuid
  3. Call PATCH /orgPersonMapping/add/{personUuid} to map the person to the logged in organization. API returns with successful person mapping to the organization.

Create person

On successful execution of step 3, the new person becomes accessible to the users of the organization so that they can start adding data to the person's EHR.

Last update: 2022-04-04