Creating and Seeding Patients

The flow for creating and seeding patients is as follows:

  • Upsert your patient to Zus as described here. This allows you to conditionally create a patient within Zus. That means that if the patient doesn't exist you'll create (POST) them, if they do exist you'll update (PUT) them. Be sure to include your local identifier for your patient.


When creating a patient, Zus will rapidly stamp a Universal Patient Identifier (UPID) on that patient. The UPID will be useful later when you want to pull data on that patient across all organizations that responded with information about the patient.

  • Seed your patient with Zus connected network data as described here. Our Patient History API will do the heavy lifting of searching our networks for patient matches, pulling documents from responding organizations and translating them to FHIR resources for you.


Be sure to pass the Patient id from the previous response in the url!

  • The seeding of your patient data takes on the order of seconds to minutes. While you're waiting for data to populate you can always check the status of your patient history call by executing the message-status request as described here.


You can always check what data we've pulled on your patient by viewing them within fhirPlace!

Follow along!

What’s Next