This page contains the setup guide and reference information for the Athena Health connector.
Prerequisites
Before connecting your Athena Health account, ensure that:
-
You are an athenaOne client with athenaCollector and athenaClinicals products enabled.
-
You have signed the A&C form with Athena to authorize Keragon integration.
-
You have access to your Practice ID from the Athena portal.
Note: Keragon integrates with the AthenaOne API, as documented here.
Setup Guide
Follow these steps to locate your Practice ID and connect Athena Health to Keragon:
-
Go to identity.athenahealth.com and log into your Athena Health account.
-
Locate your Practice ID from either:
-
The department selection dropdown, or
-
The URL in your browser's address bar.
-
-
Copy the Practice ID.
-
Open app.keragon.com and go to the Authentications section.
-
Click Create new, and select Athena Health.
-
Paste the copied Practice ID into the designated field.
-
Click Connect to complete the integration.
Need more help connecting?
Check the fully extended Athena Health connector setup guide for screenshots, detailed steps, and additional context.
Once connected, Keragon will use this practice ID to authorize and interact with Athena's APIs.
How-Tos
How to "Create Patient" in Athena
This guide walks you through the process of creating a patient in Athena using Keragon.
-
Go to app.keragon.com.
-
Start by adding a new step in your workflow.
-
In the search bar, type "Athena".
-
Click on Athena Health to view available actions.
-
Select "Create patient".
-
Choose your existing authentication or click "+ Connect new account" if needed.
-
Under Department, use the variable selector to choose a department for the patient’s registration.
-
Fill in required fields:
-
First Name
-
Last Name
-
Date of Birth
-
Email
-
-
Note: At least one of the following fields is required in addition to name/DOB:
-
Email
-
Guarantor Email
-
SSN
-
Home Phone
-
Mobile Phone
-
Work Phone
-
Zip Code
-
-
Click Save to store the configuration.
-
Click Test Step to run the workflow and confirm the setup.
-
Review Inputs and Outputs for verification.
This process enables you to dynamically register new patients in Athena from triggers or prior steps in your Keragon workflow.
Troubleshooting and Common Errors
Error Message | Cause | Suggested Fix |
---|---|---|
401 Unauthorized |
Invalid or expired authentication token | Reconnect the Athena Health connector in Keragon. |
Subscription limit exceeded |
Attempted to register multiple subscriptions for the same event/entity | Keragon allows only one subscription per event type—reconfigure as needed. |
No changes returned |
Incorrect filter or no new data available | Ensure that new data is being added to Athena and your filter parameters are accurate. |
Department ID not recognized |
Invalid or deprecated department ID used in a trigger | Confirm department ID via Athena UI and adjust filter settings if used. |
Limitations and Notes
-
Athena integration uses a polling trigger model; real-time webhooks are not supported.
-
Triggers may require up to 20 minutes to become active.
-
Only one subscription (e.g., appointments, patients triggers) per entity per practice ID is allowed at a time.
- Dashboard vs. API Inconsistencies: Some actions may be permitted in the Athena UI but blocked or unsupported via the API.
-
Department Filtering:
-
The
departmentid
filter is available but not yet required. -
If your practice has many departments, this filter may be enforced later to improve efficiency.
-
-
Keragon integrates with AthenaOne APIs, which are supported for all eligible clients.