TherapyNotes API
TherapyNotes is an electronic health record (EHR) and practice management platform built for behavioral health providers—psychotherapists, counselors, psychologists, and psychiatrists. It manages patient records, scheduling, clinical documentation, billing and insurance claims, patient portal, teleh
What is TherapyNotes?
TherapyNotes provides EHR and practice management tools for behavioral health. Core capabilities cover the full lifecycle of care and revenue operations, including scheduling, documentation, billing, and patient engagement.
Core product areas include:
- Scheduling and calendar management with appointment reminders
- Patient/client and clinician rosters with role-based access
- Clinical documentation (intake, progress notes, treatment plans, discharge summaries)
- Diagnoses and service coding (e.g., CPT 90834/90837)
- Patient portal (forms, messaging, document sharing) and telehealth
- Billing and insurance (CMS-1500/837P, ERA posting, patient payments)
- E-prescribing for prescribers via integrated networks (e.g., DrFirst)
Common data entities:
- Patients/Clients
- Clinicians/Providers (therapists, prescribers, support staff)
- Appointments (office, telehealth) and attendance
- Notes (intake, progress, treatment plans) and signatures/locking
- Diagnoses and service codes
- Insurance Policies and subscriber details
- Claims (CMS-1500/837P) and remittances (ERAs)
- Payments and invoices
- Documents and intake forms
- Locations and telehealth sessions
The TherapyNotes Integration Challenge
Teams rely on TherapyNotes daily, but turning portal-first workflows into automated pipelines is hard:
- No public API: Key scheduling, documentation, and billing operations live in web apps; exports are limited and not event-driven
- Strong security and PHI constraints: MFA, role-based permissions, locked notes, and audit trails complicate headless automation
- Calendar and messaging limitations: ICS feeds are often one-way; users request Zapier and two-way sync; patient communications need controlled templates
- Billing complexity: CMS-1500/837P submissions, payer-specific rules, and ERA posting require accurate mapping and timing windows
- E-prescribing nuances: Prescribing features are restricted to authorized clinicians and external networks; access must respect entitlements
How Supergood Creates TherapyNotes 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 patients, appointments, notes, and claim objects so you can integrate once across teams and locations
- Aligns with customer entitlements and licensing constraints to ensure compliant access
- Bridges batch exports and payer/clearinghouse submissions with signed URL retrieval and delivery; pulls ERA artifacts for reconciliation
Getting Started
- Schedule Integration Assessment
Book a 30-minute session to confirm your TherapyNotes product mix, licensing, and authentication model.
- Supergood Builds and Validates Your API
We deliver a hardened TherapyNotes adapter tailored to your workflows and entitlements.
- Deploy with Monitoring
Go live with continuous monitoring and automatic adjustments as TherapyNotes 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/client profiles with demographics, clinician assignments, and primary insurance. Use to keep rosters in sync and hydrate scheduling and billing systems.
Appointments
/appointmentsCreate or update an appointment with patient, clinician, service code, and location (office or telehealth). Generates telehealth session info when applicable.
Clinical Notes
/clinical-notesRetrieve clinical note metadata and signed document links for auditing and completeness tracking. Content access respects note locking and user permissions.
Claims
/claimsAssemble a CMS-1500 or 837P claim from completed/signed appointments. Supergood normalizes service lines and can route the generated file to your configured submission channel.
Use Cases
Roster and Schedule Synchronization
- Push patient and clinician rosters from your CRM or upstream EHR into TherapyNotes - Create appointments automatically from your scheduling system with CPT/service codes and location (office or telehealth) - Maintain a single source of truth for demographics, policies, and availability
Documentation Completeness and Quality
- Pull note metadata (type, status, signatures) to track documentation completeness - Retrieve signed PDFs for audit, outcomes measurement, or payer requests - Surface diagnosis and service coding consistency to clinical leadership
Claims Generation and Reimbursement Automation
- Bundle completed/signed encounters into CMS-1500 or 837P claims with payer-specific formatting - Submit via configured channels (payer portal, clearinghouse) and monitor statuses - Pull ERAs and reconcile payments against scheduled appointments and ledger entries
Patient Portal, Telehealth, and Engagement
- Send portal invitations and pre-visit intake packets programmatically - Generate telehealth links tied to scheduled appointments and clinician assignments - Automate reminders and attendance follow-up to reduce no-shows
Accounting and Analytics
- Sync payments and ledger entries to accounting systems (e.g., QuickBooks) - Drive operational dashboards for scheduling utilization, documentation latency, and reimbursement KPIs
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, notes, and claim artifacts
Security
Encrypted transport, scoped tokens, and audit logging; respects TherapyNotes entitlements and compliance requirements
Webhooks
Optional asynchronous delivery for appointment changes, documentation events, claim generation, and remittance updates
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 workflows across commonly used TherapyNotes modules: patients/clinicians, scheduling, documentation metadata and artifacts, claims/ERA, and payments—subject to your licensing and entitlements. We scope coverage during integration assessment.
We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Document retrieval respects permissions and note-locking; we maintain audit trails for compliant access to signed notes and billing artifacts.
Yes. You can assemble CMS-1500 or 837P files from signed encounters with payer-specific formatting. We route submissions via your configured channel (payer portal or clearinghouse) and return statuses and artifacts for reconciliation.