This page contains the setup guide and reference information for the Healthie connector.
Prerequisites
Before connecting your Healthie account, ensure that:
-
You have an active Healthie account.
-
You have submitted the "Activate a Partner" form in Healthie to request API access.
-
You have received your API key from the Healthie support team via email.
Setup Guide
Follow these steps to connect your Healthie account to Keragon:
-
Complete the "Activate a Partner" form to request API access here.
-
Wait for an email response from the Healthie team, which will include your API key and additional setup instructions.
-
Copy the API key provided in the email.
-
Go to app.keragon.com and open the Healthie connector setup.
-
Paste the API key into the appropriate field.
-
Click Connect to finalize the integration.
Note: The API key is sensitive and should be stored securely. Do not share it over insecure channels.
How-Tos
How to Extract Additional Patient Data Not Available in the Default "Get Patient" Action
If the default Get Patient action in Healthie does not return all desired data fields, follow this guide:
-
Watch the step-by-step Loom tutorial: Watch the video
-
This video demonstrates how to extract extended data points using custom requests or alternative endpoints within Keragon.
Use custom action blocks or HTTP modules in Keragon to retrieve specific data not covered by standard connectors.
Troubleshooting and Common Errors
| Error Message | Cause | Suggested Fix |
|---|---|---|
401 Unauthorized |
Invalid or missing API key | Verify the API key received from Healthie and re-enter it in Keragon. |
403 Forbidden |
API access not yet approved | Ensure you completed the "Activate a Partner" form and received API key approval. |
Incomplete data returned |
Default action doesn’t return all needed fields | Use custom HTTP requests as demonstrated in the provided Loom video. |
Connection failed |
Misconfigured integration or network issues | Recheck API key and retry. Ensure Healthie API services are up. |
Limitations and Notes
-
Healthie requires a manual approval process for API access via the Activate a Partner form.
-
Only users who receive confirmation and an API key from Healthie support can complete the integration.
-
The default "Get Patient" action may not expose all patient data; use custom HTTP steps for additional fields.