PKB maintains a dedicated endpoint at /phr-fhir which exposes a single, custom operation, designed to allow a Messaging-like way of creating new patients.
See Patient/$process-message for more information.
Create, update, and invite patients to register using the $process-message operation
Read or write any other data
Full details of the supported capabilities are defined in this CapabilityStatement:
https://pkbdev.atlassian.net/wiki/spaces/api/pages/3365011457/Capabilities+Messaging+Endpoint
The Messaging FHIR endpoint is available at a base of /phr-fhir relative to the server host.
For example, PKB's sandbox environment has a server host address of: https://sandbox.patientsknowbest.com
The corresponding Facade FHIR endpoint is therefore available at: https://sandbox.patientsknowbest.com/phr-fhir
Access to the Messaging FHIR endpoint is protected by OAuth 2.0.
Callers must provide a valid Bearer token in the Authorization HTTP header, which can be obtained from PKB by using the correct workflow for your deployment.
System Clients are also required to provide the X Org Public Id HTTP header.
Please see our OAuth 2.0 documentation for more information.
Pending
Please see the Examples page for guidance on how to interact with this endpoint.
Please see the Messaging Roadmap page for planned changes to this endpoint.