Mindoula

Supergood | Mindoula API

Alex Klarfeld

Alex Klarfeld

— 7 min read
Supergood | Mindoula API

Programmatically access behavioral health referrals, member enrollment, assessments, care management encounters, and collaborative care billing workflows in Mindoula with a stable REST API. Supergood builds and operates production-grade, unofficial Mindoula integrations so your team can automate population health and revenue operations without heavy custom engineering.

In plain English: Mindoula is a technology-enabled behavioral health company that partners with payers, providers, and health systems to identify at-risk members, engage them in care, and coordinate behavioral health services. With an unofficial API, you could ingest referrals, synchronize member rosters and program enrollments, submit PHQ-9/GAD-7 assessments, log care management minutes for Collaborative Care (CoCM) billing, and export encounter history for claims and quality reporting.

If you’re a healthcare tech startup working in billing, practice management, or provider services, integrating your stack with Mindoula unlocks concrete data flows and features:

  • Pull: Member profiles and eligibility, program enrollments, risk scores, care plans, assessments (PHQ-9, GAD-7, C-SSRS), encounter histories, appointment coordination notes
  • Push: New referrals from your EHR (Epic, Athenahealth, Cerner), updated demographics and consents, completed assessments, care management encounters with minutes and CPT codes (99492/99493/99494)
  • Build: Authorization-aware care coordination, CoCM time tracking and monthly rollups, automated billing artifact generation, longitudinal outcomes dashboards and quality reporting

What is Mindoula?

Mindoula provides behavioral health and care management services across populations including serious mental illness (SMI), substance use disorder (SUD), and integrated primary care via the Collaborative Care Model (CoCM). The company deploys tech-enabled care teams to identify high-risk members, conduct screenings, create care plans, coordinate services, and measure outcomes. Mindoula’s operational platform supports referral intake, engagement and outreach, assessment capture, encounter documentation, crisis support, and payer reporting.

Core product areas include:

  • Referral intake and triage from payers and provider organizations
  • Member enrollment, demographics, and eligibility tracking
  • Care plans, goals, and tasks managed by care teams
  • Assessments (PHQ-9, GAD-7, AUDIT-C, C-SSRS) and outcomes tracking
  • Encounter logging and time tracking for CoCM billing (99492/99493/99494)
  • Appointment coordination, telephonic/video outreach, and engagement workflows
  • Payer reporting and program-specific utilization tracking

Common data entities:

  • Members/Patients
  • Providers/Care Managers/Behavioral Health Clinicians
  • Programs and Enrollments (CoCM, SMI, SUD, Maternal Mental Health, etc.)
  • Assessments (instrument, scores, responses, severity, timestamps)
  • Encounters/Contacts (modality, duration, outcomes, billable codes)
  • Care Plans and Goals
  • Appointments and Outreach Attempts
  • Payers and Authorizations/Eligibility
  • Risk Scores and Stratification Flags

The Mindoula Integration Challenge

Organizations rely on Mindoula’s portal workflows daily, but turning them into automated pipelines is hard:

  • Program variability: Each payer/program has different enrollment criteria, outreach cadence, assessments, and billing rules (e.g., CoCM minutes by calendar month)
  • Strong enterprise security: SSO/MFA and network controls complicate headless automation and data synchronization
  • Portal-first delivery: Intake, assessments, and encounter logging often live in web apps or batch exports, not in unified public APIs
  • Compliance and audit: PHI handling, consent tracking, and assessment edit/audit trails must be preserved precisely
  • Monthly rollups: Collaborative care minutes and billing artifacts require accurate aggregation aligned to payer rules

How Supergood Creates Mindoula APIs

Supergood reverse-engineers authenticated browser flows, batch 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 member, program enrollment, assessment, and encounter objects across payer/program variants
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges batch exports and file delivery where applicable with signed URL retrieval and submission

Use Cases

EHR-to-Care Management Synchronization

  • Push referrals from your EHR (Epic, Athenahealth, Cerner) into Mindoula
  • Keep demographics, eligibility, and consents in sync
  • Maintain a single source of truth for program enrollment status

Collaborative Care Billing Automation

  • Track care manager minutes and psychiatrist consult time automatically
  • Aggregate monthly CoCM minutes and map to 99492/99493/99494
  • Export encounter bundles ready for claim generation and reconciliation

Assessment Capture and Outcomes Tracking

  • Submit PHQ-9, GAD-7, AUDIT-C, and C-SSRS results programmatically
  • Trend severity over time and trigger care plan updates
  • Surface improvement metrics for payer reporting and quality measures

Referral Intake and Outreach

  • Ingest referrals with diagnosis codes and urgency levels
  • Route outreach attempts and appointment coordination to care teams
  • Monitor conversion from referral to enrolled to engaged

Audit and Compliance

  • Preserve machine-readable audit trails for assessments, encounters, and consents
  • Export complete encounter packets with timestamps, modality, duration, and notes
  • Support payer-specific documentation requirements

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_bh_29b71a",
    "name": "Behavioral Health Admin",
    "entitlements": ["members", "programs", "assessments", "encounters"]
  }
}

Members

GET /members: Retrieve member profiles, eligibility, risk scores, and program enrollments. Use this to drive outreach, care planning, and billing eligibility checks.

Query parameters

  • programId: string
  • payerId: string
  • activeOn: ISO 8601 date
  • riskScoreMin: integer (0–100)
  • consentRequired: boolean

Example response

{
  "items": [
    {
      "memberId": "mem_91f2a0",
      "firstName": "Jordan",
      "lastName": "Patel",
      "dob": "1988-07-12",
      "contact": {"phone": "+1-614-555-0182", "email": "[email protected]"},
      "payer": {"payerId": "payer_oh-mco-123", "plan": "HMO"},
      "eligibility": {"active": true, "activeOn": "2026-01-01"},
      "consent": {"onFile": true, "updatedAt": "2026-01-15T10:12:00Z"},
      "programEnrollments": [
        {"programId": "prog_cocm", "status": "enrolled", "startDate": "2026-01-01"}
      ],
      "risk": {"behavioralRiskScore": 72, "suicideRiskFlag": false}
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Referrals

POST /referrals: Create a referral to a Mindoula program from your EHR or intake system. Include diagnosis codes, urgency, and contact preferences.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/referrals \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "member": {
      "firstName": "Ari",
      "lastName": "Nguyen",
      "dob": "1994-03-02",
      "contact": {"phone": "+1-202-555-0147", "email": "[email protected]"}
    },
    "referralSource": "primary_care",
    "referringProvider": {"npi": "1234567890", "name": "Riverbend Family Medicine"},
    "payerId": "payer_dc-medicaid",
    "programCode": "CoCM",
    "dxCodes": ["F32.1", "F41.1"],
    "urgency": "routine",
    "notes": "Patient screened positive for depression and anxiety.",
    "consent": {"provided": true, "method": "electronic", "timestamp": "2026-01-20T14:02:33Z"},
    "referenceId": "ehr-ref-85421"
  }'

Example response

{
  "referralId": "ref_7c31fa",
  "status": "received",
  "program": {"programId": "prog_cocm", "name": "Collaborative Care"},
  "memberId": "mem_aa2921",
  "createdAt": "2026-01-20T14:03:01Z",
  "referenceId": "ehr-ref-85421"
}

Assessments

POST /assessments: Submit or update behavioral health assessments (PHQ-9, GAD-7, AUDIT-C, C-SSRS) associated with a member and program enrollment.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/assessments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "memberId": "mem_91f2a0",
    "programId": "prog_cocm",
    "instrument": "PHQ-9",
    "administeredAt": "2026-01-19T15:02:33Z",
    "responses": [
      {"questionId": "phq9_q1", "answer": 2},
      {"questionId": "phq9_q2", "answer": 2},
      {"questionId": "phq9_q3", "answer": 1},
      {"questionId": "phq9_q4", "answer": 1},
      {"questionId": "phq9_q5", "answer": 2},
      {"questionId": "phq9_q6", "answer": 1},
      {"questionId": "phq9_q7", "answer": 0},
      {"questionId": "phq9_q8", "answer": 2},
      {"questionId": "phq9_q9", "answer": 0}
    ],
    "totalScore": 11,
    "severity": "moderate",
    "adminMethod": "phone",
    "referenceId": "ehr-assess-42391"
  }'

Example response

{
  "assessmentId": "asm_58d3e0",
  "instrument": "PHQ-9",
  "totalScore": 11,
  "severity": "moderate",
  "createdAt": "2026-01-19T15:02:59Z",
  "memberId": "mem_91f2a0",
  "programId": "prog_cocm"
}

Encounters

POST /encounters: Create a care management encounter with modality, duration, and optional CPT codes to support CoCM billing. Supports monthly rollup attribution and outcome tracking.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/encounters \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "memberId": "mem_91f2a0",
    "careManagerId": "cm_2208aa",
    "programId": "prog_cocm",
    "encounterType": "care_management",
    "modality": "phone",
    "startedAt": "2026-01-19T14:02:33Z",
    "endedAt": "2026-01-19T14:31:47Z",
    "durationMinutes": 29,
    "cptCodes": ["99492"],
    "billingPeriod": "2026-01",
    "outcome": "care_plan_updated",
    "notes": "Reviewed PHQ-9, adjusted care plan goals, scheduled follow-up.",
    "referenceId": "ehr-enc-42391"
  }'

Example response

{
  "encounterId": "enc_71af2b",
  "status": "recorded",
  "billableUnits": {
    "period": "2026-01",
    "minutesCounted": 29,
    "codes": ["99492"]
  },
  "createdAt": "2026-01-19T16:05:42Z",
  "memberId": "mem_91f2a0",
  "programId": "prog_cocm",
  "referenceId": "ehr-enc-42391"
}

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 members, assessments, and encounter artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects Mindoula entitlements and compliance requirements
  • Webhooks: Optional asynchronous delivery for assessment submissions, encounter rollups, and reporting extracts

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume referral intake and encounter logging 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 Mindoula product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which Mindoula programs can this integration cover?

Supergood supports workflows across commonly used Mindoula portals and agency-facing tools, subject to your licensing and entitlements. We scope coverage (e.g., referral intake, member enrollment, assessments, encounter logging, CoCM rollups) during integration assessment.

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

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For batch flows, we manage timing windows, generate reporting extracts, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I generate billing artifacts for Collaborative Care directly from encounters?

Yes. You can aggregate minutes by calendar month and map to 99492/99493/99494 with payer-specific rules. We can route submissions via your configured channel (payer/portal or clearinghouse) and return statuses and artifacts for reconciliation.

Q: Do you support assessment instruments beyond PHQ-9 and GAD-7?

We can capture and normalize additional instruments (e.g., AUDIT-C, C-SSRS) and align outputs to your quality reporting needs.

Ready to automate your Mindoula workflows?

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

Get Started →

Read more