Overview
The NextGen Healthcare connector provides a robust interface for accessing and managing electronic health records (EHR) and practice management data. It allows you to synchronize patient information, clinical encounters, appointments, and referrals with other systems in your stack. This facilitates a unified view of patient data, streamlines administrative workflows, and enables automated processes based on clinical events.
Capability summary
Authentication
Auth method: api_key
Required scopes
]
Supported objects
| Object | Read | Write | Notes |
|---|---|---|---|
| Patients | Yes | No | Patient records are read-only. Use actions to modify related data. |
| Encounters | Yes | Yes | New encounters can be created via the 'new_encounter_logged' action. |
| Appointments | Yes | Yes | New appointments can be created via the 'add_new_appointment' action. |
| Referrals | Yes | Yes | New referrals can be created via the 'create_referral' action. |
Supported actions
| Action | Description |
|---|---|
| retrieve_patient_chart | Retrieves the complete chart and medical history for a specified patient. |
| add_new_appointment | Schedules a new appointment slot for a patient with a provider. |
| create_referral | Generates a new referral for a patient to see another healthcare provider. |
| new_encounter_logged | Logs a new clinical encounter or visit for a patient in their record. |
Setup steps
- Log in to your NextGen Healthcare administrator account.
- Navigate to the API settings or developer section to generate a new API key.
- Ensure the API key has the necessary permissions to read and write data for Patients, Encounters, Appointments, and Referrals.
- In Flows360, navigate to the Connections page and create a new NextGen Healthcare connection.
- Paste the copied API key into the "API Key" field.
- Click "Connect" and Flows360 will validate the connection.
Limitations
This connector's capabilities are determined by the permissions associated with the provided NextGen Healthcare API key. Data access is limited to the objects and actions enabled for the user role tied to the key. The connector does not support bulk write operations; records are created and updated individually via specific actions.
Troubleshooting
Why is my connection failing?
Connection failures are typically due to an invalid or expired API key. Please generate a new key from your NextGen Healthcare admin panel and ensure it has been copied correctly into the Flows360 connection settings.
Why can't I write to the Patients object?
The Patients object is read-only to maintain data integrity. Patient data updates should be managed through specific actions like 'add_new_appointment' or 'new_encounter_logged' which create related records.
Certain data fields are not syncing. Why?
This is likely a permissions issue. Check the permissions associated with your API key in NextGen Healthcare. Ensure the user role has read access to all the fields required for your workflows.