1. Keragon
  2. Connectors
  3. Athena Health

Athena Health

Updated

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.

Complete the Authorization & Consent (A&C) Form

Before you can connect Athena Health to Keragon, your practice must complete the Authorization & Consent (A&C) form. This is a requirement from Athena Health for all third-party integrations and authorizes Keragon to access your practice’s data through the Athena Health API.

What is the A&C form?

The A&C form is Athena Health's standard authorization document. By completing it, your practice confirms that you have reviewed and approved Keragon as an integration partner and that you consent to sharing your practice data through the Athena Health Marketplace.

How to complete the A&C form

  1. Open the Keragon A&C form: https://marketplace.athenahealth.com/authorization-consent?product=keragon
  2. Enter your practice information, including your Practice Name and Athena Health Practice ID. If you need help finding your Practice ID, see our guide: How to find your Practice ID in Athena Health.
  3. Provide the name and email of an authorized signer at your practice (this should be someone with administrative authority).
  4. Review and sign the form electronically.
  5. After submission, Athena Health’s Marketplace team processes the request. This typically takes 1–2 business days.

What happens next?

Once the A&C form is processed:

  • Keragon will be authorized to connect to your Athena Health instance.
  • Your Keragon onboarding specialist will confirm the authorization is active.
  • You can then proceed to connect your Athena Health account in Keragon using your Practice ID and API credentials.

Common questions

Who should sign the A&C form? An authorized administrator or practice manager. This is typically the same person who signed your Athena Health Master Services Agreement.

Does the A&C form cost anything? No. The A&C form is a free authorization step required by Athena Health for all Marketplace integrations.

I submitted the form but haven’t heard back. Processing usually takes 1–2 business days. If it has been longer than 3 business days, reach out to your Keragon onboarding specialist and we’ll follow up with Athena Health on your behalf.

Can I start building workflows before the A&C is approved? You can explore the Keragon platform and set up your workflow logic, but you won’t be able to test live data from Athena Health until the A&C form is fully processed.

Setup Guide

Follow these steps to locate your Practice ID and connect Athena Health to Keragon:

00:00: In this guide, you will learn how to find your practice ID in Athena Health Follow 00:04: the steps provided to locate your practice ID efficiently. 00:09: Log in to your Athena Health Portal and copy your practice ID either from your 00:13: department selection box or your browser's address bar. 00:17: Switch to app.kn 00:20: Access the authentication section 00:23: Initiate the creation of a new item by clicking on create new. 00:28: Find the Athena Health connector. 00:31: Select the option labeled practice ID. 00:34: Paste your practice ID. 00:37: Proceed by clicking on connect 00:40: This guide covered the process of finding your practice ID and Athena Health and 00:44: creating a new authentication in caragon.

  1. Go to identity.athenahealth.com and log into your Athena Health account.

  2. Locate your Practice ID from either:

    • The department selection dropdown, or

    • The URL in your browser's address bar.

  3. Copy the Practice ID.

  4. Open app.keragon.com and go to the Authentications section.

  5. Click Create new, and select Athena Health.

  6. Paste the copied Practice ID into the designated field.

  7. 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.

00:00: This guide will walk you through the process of creating a patient in Athena using 00:04: tarragon. 00:06: Start by adding a new step for patient creation. 00:09: Search for Athena. 00:11: Select Athena from the available vendors. 00:14: Select create patient from the available actions. 00:18: Use an existing authentication or use plus, plus connect new account 00:22: to proceed with authentication creation. 00:24: If required? 00:27: Choose the patient's primary Registration Department. 00:31: Select one from the available options. 00:34: Fill in the first name. And last name for the patient you can use variables 00:38: from previous steps in the workflow. EG Trigger 00:42: step, using the variable selector. 00:45: Provide date of birth of the patient. 01:00: Save the configuration. 01:02: Perform a test step. 01:05: Review the input information. 01:07: Review the output information. 01:10: The guide, covered the essential steps required to create a patient in Athena 01:14: using tarragon.

  1. Go to app.keragon.com.

  2. Start by adding a new step in your workflow.

  3. In the search bar, type "Athena".

  4. Click on Athena Health to view available actions.

  5. Select "Create patient".

  6. Choose your existing authentication or click "+ Connect new account" if needed.

  7. Under Department, use the variable selector to choose a department for the patient’s registration.

  8. Fill in required fields:

    • First Name

    • Last Name

    • Date of Birth

    • Email

  9. 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

  10. Click Save to store the configuration.

  11. Click Test Step to run the workflow and confirm the setup.

  12. 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.

Was this article helpful?
0 out of 0 found this helpful

Articles in this section