Please note: this operation is not to be confused with the FHIR-defined $process-message. The two operations have different syntax and behaviour.
This operation allows:
a System user to create or update a Patient
Accepts a single FHIR Patient resource. Steps of processing:
If the patient does not already exist on PKB, a record will be created for them.
If the patient does already exist on PKB, their demographics will be updated.
If an email is included in the Patient resource, an invitation may be sent. Note that only one email address will be processed if more than one are provided.
Use of the team alias extension allows a patient to be added to specified teams. Multiple instances of the extension may be included to add the patient to multiple teams. If the team alias extension is included, then there must be an instance which includes the alias for the configured default team of the sending organisation.
If the team alias extension is not included in a Patient resource, the patient will be added to the configured default team of the sending organisation.
Authorisation and authentication
In addition to the OAuth 2.0 access token, the X-Org-Public-Id HTTP header must be provided in the request to specify the organisation that the system is calling on behalf of. The parameter will be the UUID of the PKB organisation.