TheraNest API
If you’re a behavioral health clinic, group practice, or health tech company integrating with TheraNest, an unofficial API unlocks practical data flows and features: - Pull: Clients, insurance policies, diagnoses, appointments, telehealth session details, clinical notes and treatment plans (includin
What is TheraNest?
TheraNest provides cloud-based practice management and EHR tools designed for behavioral and mental health practices. Core workflows include intake forms, appointment scheduling and reminders, telehealth sessions, progress notes and treatment plans, billing and insurance claims, client portal, and reporting.
Core product areas include:
- Scheduling, reminders, and telehealth session management
- Client portal (intake forms, payments, document sharing)
- Clinical documentation (progress notes, treatment plans, diagnoses)
- Billing (invoices, statements), insurance claim submission, ERA posting
- Staff/provider management and roles/permissions
- Reporting and outcomes tracking (e.g., PHQ-9, GAD-7)
Common data entities:
- Clients (demographics, contacts, portal status)
- Providers (clinicians, supervisors, support staff)
- Appointments (service codes, POS, status, telehealth links)
- Clinical Notes (progress notes, treatment plans, signatures)
- Diagnoses (ICD-10), problem lists, goals/objectives
- Insurance Policies (payers, subscriber details)
- Invoices, payments, and write-offs
- Claims (CMS-1500/837P service lines, statuses)
- Remittances (ERA summaries for reconciliation)
The TheraNest Integration Challenge
Teams rely on TheraNest daily, but converting portal-first workflows into automated pipelines is challenging:
- Limited public APIs: Many essential scheduling, documentation, and billing features are available only via the web app or exports
- Reporting/export constraints: CSV/Excel downloads and timing windows lead to brittle, manual data ops
- Telehealth link management: Creating and distributing session links from external schedulers is hard without automation
- Cross-calendar workflows: Keeping TheraNest schedules in sync with Google/Microsoft calendars or field apps requires careful reconciliation
- Clearinghouse variability: Claim submission, status retrieval, and ERA posting may differ across channels (e.g., Apex EDI, Claim.MD)
- Enterprise security: SSO/MFA and role-based permissions complicate headless automation
How Supergood Creates TheraNest 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 client, appointment, documentation, and claim objects across TheraNest account configurations
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges batch exports and clearinghouse flows where applicable with signed URL retrieval and delivery
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your TheraNest product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened TheraNest adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as TheraNest 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.
Clients
/clientsRetrieve client profiles with demographics, insurance policies, diagnoses, and portal status. Use filters to limit by provider, last update, or active status.
Appointments
/appointmentsCreate or update an appointment with service details, telehealth settings, reminders, and status transitions.
Clinical Notes
/clinical/notesCreate or update a clinical note or treatment plan. Supports SOAP sections, diagnosis codes, outcomes measures, and locking/sign-off.
Claims
/billing/claimsAssemble a CMS-1500/837P claim from completed appointments and signed notes. Supergood normalizes service lines and can route the generated file to your configured clearinghouse.
Use Cases
Intake and Roster Synchronization
- Push clients from your CRM or intake tool into TheraNest - Update demographics, portal status, and insurance details automatically - Maintain a single source of truth for client profiles
Scheduling and Telehealth Automation
- Create appointments with correct CPT, modifiers, and place of service - Generate telehealth session links and deliver reminders to clients - Keep external calendars (Google/Microsoft) reconciled with TheraNest
Clinical Documentation and Outcomes
- Create progress notes with SOAP sections, diagnoses, and measures - Lock/sign notes with auditable metadata and provider attribution - Track PHQ-9/GAD-7 trends to drive outcomes reporting
Claims Generation and Reconciliation
- Assemble CMS-1500/837P claims from completed appointments and signed notes - Route submissions via your configured clearinghouse (e.g., Apex EDI or Claim.MD) - Pull claim statuses and ERA summaries for automatic reconciliation
Audit and Compliance
- Export machine-readable note packets, signatures, and treatment plan histories - Preserve audit trails for changes and sign-offs - Demonstrate documentation coverage for billed services
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 appointments, notes, and claim artifacts
Security
Encrypted transport, scoped tokens, and audit logging; respects TheraNest entitlements and compliance requirements
Webhooks
Optional asynchronous delivery for appointment updates, note sign-offs, and claim status changes
Latency
Sub-second responses for list/detail queries under normal load
Throughput
Designed for high-volume scheduling, documentation, and billing 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 commonly used TheraNest portals and agency-facing features, subject to your licensing and entitlements. We scope coverage (e.g., clients, scheduling/telehealth, documentation, billing/claims, and exports) during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and operate behind SSO/OAuth when enabled. For batch flows, we manage export timing, generate CMS-1500/837P files, and retrieve signed URLs or delivery confirmations programmatically (e.g., via clearinghouses such as Apex EDI or Claim.MD).
Yes. You can assemble CMS-1500/837P from billable sessions with payer-specific formatting. We can route submissions via your configured channel and return statuses and artifacts for reconciliation.