NextGen API

Last reviewed: August 2026

Overview

Integuru's NextGen integration provides production-ready HTTP API access to NextGen Healthcare (MediTouch/HealthFusion), the ambulatory EHR widely deployed by mid-size physician practices, at login.healthfusion.com, covering 10 actions across patient creation, patient lookup, appointment scheduling, appointment status management, and location and resource discovery. Integuru is HIPAA-compliant and signs BAAs at no additional cost. Calls complete in under 3 seconds with a 99.9%+ success rate via direct HTTP requests rather than browser automation.

Ambulatory scheduling and patient management. NextGen's HealthFusion platform organises scheduling around calendar resources (providers), practice locations, and appointment types. Integuru's integration exposes the full scheduling surface: look up locations and resources, query existing appointments by date or time window, create new appointments with appointment type and provider selection, and update appointment status through the check-in and workflow lifecycle. Patient management actions cover creation with address and emergency contact fields, multi-mode search, and filter-based retrieval.

The integration spans the core ambulatory workflow: location and resource discovery via list_locations and list_calendar_resources, appointment retrieval via query_appointments and get_appointments, appointment creation via create_appointment, appointment status updates via update_appointment_status, patient creation via create_patient, and patient lookup via list_patients, search_patient, and get_patients. See the Canvas Medical integration for another modern ambulatory scheduling EHR, or browse the full integrations catalogue.

---

Use Cases

Integuru's NextGen integration covers the scheduling, patient management, and location lookup workflows that ambulatory healthcare engineering teams need to automate.

• Location and resource discovery: Call list_locations with no parameters to retrieve all practice locations and their IDs. Call list_calendar_resources with no parameters to retrieve all calendar resources (providers), each including its associated location_id.
• Appointment retrieval by date: Call query_appointments with date (MM/DD/YYYY) and location_id to retrieve all appointments for a location on a given day.
• Appointment retrieval by time window: Call get_appointments with startHour, endHour (both in H:00am/H:00pm format, on the hour), and locationId to retrieve appointments within a specific time window.
• Appointment creation: Call create_appointment with appt_type (appointment type ID from list_appointment_types), member_id (patient ID), location_id, current_date (MM/DD/YYYY H:MM AM/PM format), and calendar_resource_id (provider ID from list_calendar_resources). Optionally include notes (max 2,000 chars), follow_up (max 255 chars), and transition_of_care type.
• Appointment status management: Call update_appointment_status with appointment_id and status. For CHECK_IN, also pass member_id. All other status transitions only require appointment_id and status.
• Patient creation: Call create_patient with first_name, last_name, zip, city, state, gender (exactly 'Female', 'Male', or 'Undifferentiated'), address1, and home_phone required. All contact, demographic, and emergency contact fields are optional. If emergency_last_name is provided, emergency_relationship becomes required.
• Multi-mode patient search: Call list_patients with query and search_by ('name', 'dob', 'phone', 'ssn', or 'chart') for flexible patient lookup. Filter by search_type ('Patient', 'Insured', 'Guarantor', 'All', 'NewPatient').
• Quick name search: Call search_patient with patient_name (minimum 3 characters, 'Last' or 'Last, First' format) for a fast case-insensitive name lookup.
• Filter-based patient retrieval: Call get_patients with any combination of dob, ssn, home_phone, patient_name (partial 'Last, First' match), or patient_account_no to retrieve matching patient records.
• AI agent tooling: The location, resource, and appointment actions provide a complete scheduling toolkit for healthcare AI agents that need to check availability, book appointments, or manage patient check-in flows programmatically.

---

Setup Notes

Integuru's NextGen integration authenticates against https://login.healthfusion.com/. Configure credentials once during Integuru setup; Integuru manages authentication and session handling automatically.

The typical scheduling workflow sequence is: call list_locations to get location_id values, call list_calendar_resources to get calendar_resource_id values (each resource includes its location_id), then pass those IDs to create_appointment alongside appt_type (from list_appointment_types) and member_id (from a patient lookup action). For appointment retrieval, query_appointments uses date in MM/DD/YYYY format; get_appointments uses startHour/endHour in H:00am/H:00pm format (must be on the hour).

For create_appointment, current_date must include both date and time in 'MM/DD/YYYY H:MM AM/PM' format. notes allows up to 2,000 characters; follow_up up to 255 characters. For update_appointment_status, member_id is only required when the status value is CHECK_IN.

For create_patient, gender must be exactly 'Female', 'Male', or 'Undifferentiated' (case-sensitive). Phone fields accept dashes and parentheses (stripped automatically). If emergency_last_name is provided, emergency_relationship becomes required; supply relationship codes such as MTH, FTH, HUSB, WIFE, or BRO.

Full parameter documentation is available for actions marked with the docs badge in the action table above.