Connect to your ZapEHR FHIR Server

ZapEHR uses OAuth authentication. Configuring the ZapEHR server to allow Vanya to access it is very simple. Click on the “Add New Server” button on Vanya’s home page.

Add new server

In the Server Details popup dialog, give the new server a name: “ZapEHR”. Copy the base URL for the ZapEHR FHIR server into the URL input box: https://fhir-api.zapehr.com/r4

ZapEHR server settings

Next, get the Id and Secret for your ZapEHR application and copy them into the Client Id and Client Secret inputs on the OAuth authentication tab. Set the Token Endpoint to https://auth.zapehr.com/oauth/token and the Grant Type to client_credentials. Add an extra parameter to the bottom of the page for “audience” with a value of “https://api.zapehr.com”.

ZapEHR OAuth settings

Save the changes to exit the dialog, then click Connect next to the ZapEHR server name. If a failure message appears, go back and look at all the values you’ve entered, and refer back to your ZapEHR client values to ensure everything is correct.