For Harbor Partners: Connect your E-Lab into Healthie

Overview

Healthie's lab integration ecosystem enables third-party lab partners to seamlessly connect with our platform, creating a comprehensive lab ordering and results management solution that enhances provider workflow efficiency and patient care coordination. Our existing partnerships with companies like Evexia, Fullscript, Quest Diagnostics, LabCorp, Change Healthcare, and Rupa Health, alongside our built-in lab solutions, demonstrate the platform's flexibility in supporting diverse lab vendor needs while maintaining consistent user experiences.


Key benefits of integrating as a Healthie lab partner include:

  • Streamlined provider workflow - Enables healthcare providers to place lab orders directly through familiar Healthie interfaces, eliminating the need to switch between multiple platforms
  • Enhanced patient experience - Allows clients to complete lab processes through integrated scheduling and payment systems, with automatic notifications and guidance throughout the testing journey
  • Comprehensive results integration - Automatically delivers lab results back into the provider portal in both the patient's document section for full report viewing and as discrete data fields in metrics for trending and analysis
  • Real-time order tracking - Provides webhook-driven status updates throughout the entire lab fulfillment process, from order placement through result delivery
  • Unified patient record - Consolidates all lab data within the patient's comprehensive health record, improving clinical decision-making and care continuity
  • Scalable API architecture - Leverages Healthie's GraphQL API that processes 400+ million calls monthly, ensuring reliable performance and enterprise-grade integration capabilities
  • Marketplace visibility - Gains access to Healthie's growing customer base through the Harbor Marketplace Partner program, expanding market reach and business opportunities

This integration approach simplifies the traditional lab ordering process into a seamless, end-to-end workflow that benefits providers, patients, and lab partners alike while maintaining the highest standards of healthcare data security and compliance.

Marketplace partner integration process

  • Prospective E-Labs vendors must complete the Harbor Marketplace Partner Application to access integration resources. The process includes partnership agreement execution, sandbox API access and review and approval process by Healthie's Team
  • Integration requirements include serving mutual customer bases with Healthie, technical integration capability via GraphQL API, healthcare compliance understanding, and ongoing maintenance commitment.
  • Existing lab integrations demonstrate successful patterns: Quest Diagnostics, LabCorp, Change Healthcare (500+ lab companies), Rupa Health (35+ specialty labs), and Evexia Diagnostics provide reference architectures for E-Labs vendor implementation.

Implementation best practices and considerations

  • Technical optimization strategies include using Apollo Client or GraphQL-Client for robust GraphQL integration, implementing proper error handling with comprehensive logging, and leveraging webhook batching for multiple lab values to minimize API calls.
  • Security and compliance measures require implementing signature verification for all webhooks, using sandbox environments for development testing, maintaining proper API key security, and ensuring HIPAA-compliant data handling throughout the integration.
  • Scalability considerations involve understanding rate limiting (no specific limits but 300-500ms average response time), implementing idempotent webhook handling for duplicate deliveries, and planning fallback strategies for webhook failures with alternative data retrieval methods.

The platform's API-first architecture ensures feature parity between integrated solutions and Healthie's native functionality, while comprehensive documentation through GraphiQL explorer and versioned schema references supports ongoing development and maintenance requirements for E-Labs vendor integrations.

Bidirectional workflow pattern:

  1. External system creates lab order via GraphQL mutation
  2. Healthie processes order and fires webhook notification
  3. Order status updates trigger lab_order.updated webhooks throughout fulfillment
  4. Results availability triggers final webhook with completion notification
  5. External system updates and stores results using document/metrics APIs

Provider lab order workflow implementation

E-Labs vendors can integrate using the Marketplace Partner pattern, where lab ordering occurs in the partner's UI with results synchronized back to Healthie. The core lab ordering workflow uses the createLabOrder GraphQL mutation

graphql
mutation createLabOrder($input: LabOrderInput!) {
  createLabOrder(input: $input) {
    labOrder {
      id
      status
      clientId
      labVendor
      testNames
      requisitionNumber
      reviewingProviderId
    }
    messages {
      field
      message
    }
  }
}

Required order fields include client demographics (name, DOB, address), lab vendor selection, specific test panels, reviewing physician ID, billing type, and ICD-10 codes for insurance billing. The system supports both draft and pending order statuses, with automatic patient demographic population from existing charts.

Real-time order tracking occurs through webhook notifications, specifically the lab_order.updated event that triggers whenever order status changes. This enables immediate visibility into order progress from placement through result delivery.

Patient lab completion process

Patients interact with lab orders through automated notification systems that send email/SMS confirmations with requisition details. The platform integrates with major lab vendor scheduling systems, enabling seamless appointment booking at nearby draw sites.

Geographic and age restrictions apply: services are unavailable in NY, NJ, RI, AZ, or Puerto Rico due to state regulations, and patients must be 18+ years old. Payment methods include out-of-pocket and HSA/FSA cards, with valid photo ID required for lab draws.

The Client Package method allows providers to bundle lab tests within purchasable packages, where clients buy directly and receive automatic guidance to lab sites. Results automatically return to both provider and client portals within the standard processing timeline.

Lab results integration architecture

Lab results integration supports dual delivery methods: PDF documents through the createDocument mutation and discrete lab values via the createEntry mutation. This enables comprehensive result storage in both the patient's document section and as trackable metrics.

Document storage workflow: API Docs

graphql
mutation uploadLabResult {
  createDocument(input: {
    file: $labResultFile,
    display_name: "Lab Results - [Date]",
    folder_id: $patientLabFolder
  }) {
    document {
      id
      display_name
      created_at
    }
  }
}

Discrete metrics integration:

graphql
mutation addLabValue {
  createEntry(input: {
    metric_stat: "Glucose",
    value: "95",
    user_id: $patientId
  }) {
    entry {
      id
      value
      created_at
    }
  }
}

Results automatically organize into provider-specific folders (e.g., "Evexia Lab Results", "Rupa Health Lab Results") with comprehensive permission controls. Providers receive internal bell notifications when new results arrive, while patients access results through secure portals with explicit sharing controls.

Did this answer your question? Thanks for the feedback There was a problem submitting your feedback. Please try again later.