Sunwave

Last reviewed: July 2026

Overview

Integuru's Sunwave integration provides production-ready HTTP API access to Sunwave, the behavioral health and substance use disorder treatment EMR at emr.sunwavehealth.com, covering 9 actions across patient management, admission tracking, clinical form retrieval and writing, document access, and group session data. All 9 actions carry full richer documentation. Integuru connects via direct HTTP requests rather than browser automation, so calls complete in under 3 seconds with a 99.9%+ success rate.

Built for behavioral health complexity. Sunwave organises clinical data around admissions and form instances: each patient can have multiple admissions, each admission can have multiple forms, and each form has individually addressable fields. Integuru's write_patient_chart_field action exposes this model directly, targeting specific fields by form_id, field_id, and form_instance_id so tech teams can update chart data programmatically without navigating the full form UI.

The integration covers the core behavioral health documentation workflow: facility and user lookup via get_service_facilities and list_users, patient roster retrieval via get_patients, admission history via get_patient_admissions, form listing and retrieval via get_patient_forms and get_patient_form_data, document access via retrieve_document, group session notes via get_group_header_with_time, and chart field writes via write_patient_chart_field. See the ClearCare integration for another home care clinical platform, or browse the full integrations catalogue.

---

Use Cases

Integuru's Sunwave integration covers the patient, admission, and clinical documentation workflows that behavioral health tech teams need to automate.

• Facility and user lookup: Call get_service_facilities with no parameters to retrieve all service facilities. Call list_users with no parameters to retrieve all staff users. Both are useful for building filter values before querying patients.
• Patient roster retrieval: Call get_patients with optional search_input (name filter), level_of_care (e.g., 'Res', 'PHP', 'OP', 'Detox'), program, gender, and service_facility to retrieve a filtered patient list. Pass 'All' to any filter to include all values.
• Admission history: Call get_patient_admissions with patient_id (Sunwave internal ID) to retrieve all admission records for a patient, including the admission_id values needed for form and chart actions.
• Form listing: Call get_patient_forms with admission_id to retrieve all forms associated with a specific admission, including their form_id and form_instance_id values.
• Form data retrieval: Call get_patient_form_data with patient_id, admission_id, form_id, and form_instance_id to retrieve the full data for a specific form instance (e.g., a completed Bio Psychosocial or Pre-Assessment form).
• Document retrieval: Call retrieve_document with mri (patient MRI number) and form_instance_id (UUID for the attachment) to retrieve a specific document. Omit version to get the latest version; pass a version hash to retrieve a specific historical version.
• Group session notes: Call get_group_header_with_time with group_id and form_instance_id to retrieve header data and timing information for a group therapy session note.
• Chart field writes: Call write_patient_chart_field with patient_id, admission_id, form_id, field_id, form_instance_id, and value to write a single field in a clinical chart. Use the type parameter to handle special field types: 'yesNoExplain' for radio fields (with radioValue), 'textareaWithNone' for composite fields (with checkboxValue), and the data array for multiselect checkboxes.

---

Setup Notes

Integuru's Sunwave integration authenticates against https://emr.sunwavehealth.com/SunwaveEMR/SunwaveClient/build/web/firsttabs.html. Configure credentials once during Integuru setup; Integuru manages authentication and session handling automatically.

Most chart and form actions require an admission_id alongside a patient_id. The standard lookup sequence is: call get_patients to find the patient, call get_patient_admissions with the patient's internal ID to retrieve admissions, then call get_patient_forms with an admission_id to get the form list and their form_instance_id values. For write_patient_chart_field, the field_id is the zero-based uniqueId from the form schema, retrievable via get_patient_form_data.

All 9 actions carry richer documentation available via the Integuru dashboard after setup. Full parameter documentation is available for actions marked with the docs badge in the table above.