WellSky

Supergood | WellSky API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | WellSky API

Programmatically access patient rosters, appointments, encounter documentation, and payer authorizations in WellSky with a stable REST API. Supergood builds and operates production-grade, unofficial WellSky integrations so your team can automate care coordination, clinical workflows, and billing readiness without heavy custom engineering.

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 could synchronize patients and practitioners, schedule and manage appointments, retrieve encounter notes and diagnoses, validate payer authorizations, and streamline downstream revenue cycle and reporting.

If you’re a health system, provider group, care coordination platform, or RCM team, integrating your tech stack with WellSky unlocks concrete data flows and features:

  • Pull: Patient demographics, practitioner rosters, appointments, encounters and clinical notes, diagnoses, procedures, care plans, payer coverages/authorizations
  • Push: New/updated patients and practitioners from your source EHR/CRM, scheduled appointments, care plan updates, referral intake data
  • Build: Authorization-aware scheduling, clinical documentation pipelines, decision support and care coordination dashboards, billing pre-checks based on encounter evidence

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

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

Available Endpoints

Authentication

POST /sessions: Establish 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.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Basic <Base64 encoded token>' \
  --header 'Content-Type: application/json' \
  --data '{
    "username": "[email protected]",
    "password": "<password>",
    "mfa": {
      "type": "totp",
      "code": "123456"
    }
  }'

Example response

{
  "authToken": "eyJhbGciOi...",
  "expiresIn": 3600,
  "user": {
    "id": "u_f3a271",
    "name": "EHR Admin",
    "entitlements": ["patients", "appointments", "encounters", "authorizations"]
  }
}

Patients

GET /patients: Retrieve patient demographics, identifiers, coverage, and last-updated metadata. Useful for roster synchronization and referral intake.

Query parameters

  • externalMrn: string
  • name: string (search across given/family)
  • birthDate: ISO 8601 date
  • updatedSince: ISO 8601 timestamp
  • coveragePayerId: string

Example response

{
  "items": [
    {
      "patientId": "pat_91c0b2",
      "externalMrn": "MRN-204819",
      "name": {"given": "Avery", "family": "Nguyen"},
      "birthDate": "1979-11-03",
      "gender": "female",
      "identifiers": [
        {"system": "http://hospital.example/mrn", "value": "MRN-204819"},
        {"system": "http://hl7.org/fhir/sid/us-ssn", "value": "***-**-4321"}
      ],
      "contact": {
        "phone": "+1-512-555-0199",
        "email": "[email protected]",
        "address": {"line1": "100 Care Way", "city": "Austin", "region": "TX", "postalCode": "78701"}
      },
      "coverage": [
        {"coverageId": "cov_02df1a", "payerId": "payer_bcbs-tx", "plan": "PPO", "memberId": "M1234567", "active": true}
      ],
      "lastUpdated": "2026-01-21T16:48:22Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Appointments

POST /appointments: Create or update an appointment with practitioner, location, and time data. Supports authorization checks and status updates.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/appointments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "patientId": "pat_91c0b2",
    "practitionerId": "prc_a1039e",
    "location": {"name": "WellSky Clinic - Austin", "npi": "1234567890"},
    "service": {"code": "97110", "description": "Therapeutic exercises"},
    "authorizationId": "auth_6b27c4",
    "start": "2026-01-26T14:00:00Z",
    "end": "2026-01-26T14:45:00Z",
    "status": "booked",
    "notes": "Initial PT evaluation followed by therapeutic exercises.",
    "referenceId": "ehr-schedule-84219"
  }'

Example response

{
  "appointmentId": "apt_5f94d1",
  "status": "booked",
  "createdAt": "2026-01-21T17:12:05Z",
  "authorizationChecked": true,
  "referenceId": "ehr-schedule-84219"
}

Encounters

GET /encounters: Retrieve finalized encounter records with diagnoses, procedures, vitals, and documentation summaries. Ideal for clinical exchange and billing readiness.

Query parameters

  • patientId: string
  • practitionerId: string
  • dateFrom: ISO 8601 date
  • dateTo: ISO 8601 date
  • status: string (planned, in-progress, finished)

Example response

{
  "items": [
    {
      "encounterId": "enc_7c21e9",
      "patientId": "pat_91c0b2",
      "practitionerId": "prc_a1039e",
      "type": "outpatient",
      "start": "2026-01-19T14:00:13Z",
      "end": "2026-01-19T14:47:32Z",
      "status": "finished",
      "diagnoses": [
        {"code": "M54.5", "system": "ICD-10", "description": "Low back pain"}
      ],
      "procedures": [
        {"code": "97110", "system": "CPT", "units": 3, "description": "Therapeutic exercises"}
      ],
      "vitals": {"bpSystolic": 118, "bpDiastolic": 76, "heartRate": 72},
      "notesSummary": "Patient tolerated exercises; plan to increase intensity next session.",
      "documents": [
        {"type": "progress_note", "url": "https://download.wellsky.example/signed/abc123...", "size": 12456}
      ],
      "lastUpdated": "2026-01-19T15:01:04Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Authorizations

GET /authorizations: Retrieve payer/member service authorizations with allowed units, service codes, and date ranges. Use this to validate scheduling and encounter eligibility.

Query parameters

  • patientId: string
  • payerId: string
  • serviceCode: string (HCPCS/CPT)
  • activeOn: ISO 8601 date

Example response

{
  "items": [
    {
      "authorizationId": "auth_6b27c4",
      "authorizationNumber": "A-2026-00917",
      "patientId": "pat_91c0b2",
      "payerId": "payer_bcbs-tx",
      "plan": "PPO",
      "serviceCode": "97110",
      "modifiers": [],
      "unitsAuthorized": 12,
      "unitsRemaining": 9,
      "startDate": "2026-01-01",
      "endDate": "2026-03-31",
      "status": "active"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Get full API Specs →

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

Performance Characteristics

  • 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

Getting Started

  1. Schedule Integration Assessment

Book a 30-minute session to confirm your WellSky product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

We deliver a hardened WellSky adapter tailored to your workflows and entitlements.

  1. Deploy with Monitoring

Go live with continuous monitoring and automatic adjustments as WellSky evolves.

Schedule Integration Call →

Frequently Asked Questions

Q: Which WellSky products can this integration cover?

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.

Q: How are MFA, SSO/OAuth, FHIR, and batch interfaces handled for automation?

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.

Q: Can I write data (e.g., appointments or care plans) back to WellSky?

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.

Ready to automate your WellSky workflows?

Supergood can have your WellSky integration live in days with no ongoing engineering maintenance.

Get Started →

Read more