WellSky API
WellSky is healthcare software used across home health, hospice, personal care, rehabilitation, behavioral health, and community care settings. It provides EHR capabilities for scheduling, care planning, clinical documentation, referrals, authorizations, and billing. With an unofficial API, you coul
What is WellSky?
WellSky provides enterprise EHR and care management solutions that support post-acute and community-based care. Product lines span home health and hospice (formerly Kinnser), personal care/EVV, rehabilitation, behavioral health, HME/DME, and social care coordination. WellSky offerings cover patient intake, scheduling, care plans, clinical documentation, authorizations, and connections to reimbursement channels and quality reporting.
Core product areas include:
- Patient/client and practitioner rosters
- Scheduling and appointment management
- Care planning and goals/interventions
- Encounter documentation and visit notes (diagnoses, procedures, vitals)
- Referrals and transitions of care
- Payer coverage and authorizations
- Exports and billing support for claims and remittances
- Interoperability via FHIR/HL7 interfaces
Common data entities:
- Patients (demographics, identifiers, coverage)
- Practitioners (NPI, roles, specialties)
- Appointments (slots, location, status)
- Encounters (visit metadata, diagnoses, procedures, notes)
- Care Plans (goals, activities, outcomes)
- Referrals/Orders (source, reason, priority)
- Coverage/Authorizations (payer, service codes, units, dates)
The WellSky Integration Challenge
Organizations rely on WellSky daily, but turning portal-centric EHR workflows into automated pipelines is hard:
- Product variability: Different WellSky products and tenants expose different features and data models; FHIR coverage may vary by module and configuration
- Write constraints: Many interfaces are read-first; write access (e.g., appointments, care plans) may require specific roles, entitlements, or paid API options
- Authentication complexity: SSO/MFA, rotating cookies, and organization-level permissions complicate headless automation
- Batch and timing: HL7/SFTP feeds, nightly exports, and submission windows require orchestration and retry logic
- Mapping and codes: Localized service codes, program rules, and custom fields must be normalized for consistent cross-site behavior
Users commonly request better real-time APIs for scheduling, patient roster sync, and encounter exports, as well as clearer write capabilities and sandbox access. Complaints often mention fragmented FHIR coverage (e.g., certain assessments or forms not available as FHIR resources), portal-first workflows, and extra effort or fees to enable API connectivity.
How Supergood Creates WellSky APIs
Supergood reverse-engineers authenticated browser flows, FHIR/HL7 interfaces, and network interactions to deliver a resilient API endpoint layer.
- Handles username/password, SSO/OAuth, and MFA (SMS, email, TOTP) securely
- Maintains session continuity with automated refresh and change detection
- Normalizes patients, appointments, encounters, and authorization objects across WellSky products
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges batch exports and SFTP/EDI flows with signed URL retrieval and delivery when real-time APIs are limited
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your WellSky product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened WellSky adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as WellSky evolves.
API Endpoints
Authentication
/sessionsEstablish a session using credentials. Supergood manages MFA (SMS, email, TOTP) and SSO/OAuth when enabled. Returns a short-lived auth token maintained by the platform.
Patients
/patientsRetrieve patient demographics, identifiers, coverage, and last-updated metadata. Useful for roster synchronization and referral intake.
Appointments
/appointmentsCreate or update an appointment with practitioner, location, and time data. Supports authorization checks and status updates.
Encounters
/encountersRetrieve finalized encounter records with diagnoses, procedures, vitals, and documentation summaries. Ideal for clinical exchange and billing readiness.
Authorizations
/authorizationsRetrieve payer/member service authorizations with allowed units, service codes, and date ranges. Use this to validate scheduling and encounter eligibility.
Use Cases
Referral Intake and Patient Synchronization
- Push patients from your CRM or source EHR into WellSky - Keep demographics and coverage/insurance synchronized - Capture referral details and track acceptance
Authorization-Aware Scheduling
- Validate payer authorizations before booking therapy or skilled nursing visits - Track units remaining and avoid over-utilization - Surface program rules (service codes, modifiers, date ranges) to schedulers
Clinical Data Exchange and Decision Support
- Pull encounter notes, diagnoses, procedures, vitals, and care plan updates - Feed decision support tools and care coordination dashboards - Trigger follow-ups based on diagnoses and outcomes
Billing Readiness and Reconciliation
- Pre-check authorization and encounter completeness before claim generation - Bundle encounter evidence with service lines for downstream RCM - Reconcile payer responses alongside clinical documentation
Technical Specifications
Authentication
Username/password with MFA (SMS, email, TOTP) and SSO/OAuth where enabled; supports service accounts or customer-managed credentials
Response format
JSON with consistent resource schemas and pagination
Rate limits
Tuned for enterprise throughput while honoring licensing and usage controls
Session management
Automatic reauth and cookie/session rotation with health checks
Data freshness
Near real-time retrieval of patients, appointments, encounters, and authorization artifacts
Security
Encrypted transport, scoped tokens, and audit logging; respects WellSky entitlements and compliance requirements
Webhooks
Optional asynchronous delivery for encounter updates, appointment changes, and authorization deltas
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume scheduling and clinical data pipelines
Reliability
Retry logic, backoff, and idempotency keys minimize duplicate actions
Adaptation
Continuous monitoring for UI/API changes with rapid adapter updates
Frequently asked questions
Supergood supports workflows across commonly used WellSky portals and modules, subject to your licensing and entitlements. We scope coverage (e.g., patients/practitioners, scheduling, encounter exports, authorizations) during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and operate behind SSO/OAuth when enabled. We consume FHIR where available, bridge gaps via authenticated browser automation, and manage HL7/SFTP timing windows with signed URL retrieval and delivery confirmations.
Where customer entitlements allow write operations, yes—Supergood can create/update appointments and select clinical resources, with audit trails and guardrails. In read-only environments, we provide safe fallbacks and reconciliation.