3. Get verification from your EHR vendor
After you review your organization and FHIR API endpoint details (as previously described), you’re ready for your EHR vendor to verify that your FHIR API endpoint is configured properly.
Note: If Epic is your EHR vendor, enter your FHIR base URL. You won’t enter an access code.
Enter your access code
The secure access code ensures that only your organization can publish information for the FHIR API endpoint.
Go to the FHIR API Profile screen for the endpoint.
Click Request.
An email is sent to your EHR vendor. Your vendor verifies your organization, sends a FHIR base URL to Apple, and generates a secure access code.
Check your email for a message from Apple with the title “Access code granted.”
Important: For security purposes, the email is sent to your vendor’s designated contact in your organization. If you’re not the designated contact, identify who is, and ask your colleague to look for the email from Apple with the title “Access code granted.”
When the message arrives, open it, then copy the access code contained in the message.
Return to the FHIR API Profile screen, then click Enter Access Code at the top right.
Paste the access code into the window, then click Done.
The buttons to request and enter an access code are replaced with either the button Start Test or the button Add Test Account.
If necessary, add a test patient account
If the button Add Test Account appears at the top right of the FHIR API Profile screen, do the following:
Click Add Test Account.
Note: The Add Test Account button doesn’t appear if your EHR vendor is athenahealth, Cerner (CommunityWorks or PowerWorks), or DrChrono.
Enter the user name and password for the test patient account provided by your EHR vendor or set up by your organization, then click Done.
If Epic is your EHR vendor, enter your FHIR base URL
Sign in to the Apple Health page on open.epic, then obtain your FHIR base URL.
Return to the FHIR API Profile screen for the endpoint.
Enter the Production URL.
If you know the next planned upgrade date, enter it. (The information helps Apple plan for any impact to your FHIR API endpoint.)
If you haven’t already added a test patient account, click Add Test Account, enter the user name and password for the test patient account (as provided by Epic), then click Done.
Click Start Test at the top right of the FHIR API Profile screen. (This initiates an email to Apple stating that Apple can complete the configuration steps that are specific to your Epic FHIR API endpoint.)
Wait for an email from Apple stating that your FHIR API endpoint is ready for testing.
Return to the FHIR API Profile screen for the endpoint.
You’re prompted to start the test again.
When Start Test appears at the top right of a FHIR API Profile screen, you’re ready to test the endpoint. Follow the instructions in Test your FHIR API endpoint.