← Back to all docs

SimplePractice API

Programmatically access scheduling, clients, intake documents, clinical documentation, and insurance billing workflows in SimplePractice with a stable REST API. Supergood builds and operates production-grade, unofficial SimplePractice integrations so your team can automate core practice management t

By Alex KlarfeldJanuary 25, 2026
SimplePractice API

What is SimplePractice?

SimplePractice is a cloud EHR and practice management platform focused on solo and group practices in behavioral health and related outpatient care. Core capabilities typically include:

  • Scheduling and calendar management (office, telehealth, group sessions)
  • Client portal with online booking, messaging, and document sharing
  • Paperless intake forms, e-signatures, and consent management
  • Telehealth by SimplePractice with HIPAA-compliant video
  • Clinical documentation (progress notes, treatment plans, diagnoses)
  • Insurance billing (837P) and remittance (835) reconciliation
  • Payment processing and card-on-file for private pay
  • Basic reporting across caseload, financials, and productivity
  • Team management, roles/permissions, audit trails

Common data entities:

  • Clients (demographics, contacts, portal status, insurance)
  • Clinicians/Staff (roles, NPI, taxonomy, locations)
  • Appointments/Sessions (service codes, status, telehealth links)
  • Services (CPT codes, fee schedules, POS, modifiers)
  • Insurance Policies (payer, member ID, plan, copay)
  • Claims (837P lines, payer, status, adjudication)
  • Remittances/ERAs (835 summaries, payment posting)
  • Payments, Invoices, and Superbills
  • Clinical Notes and Treatment Plans (templates, signatures, locks)
  • Intake Forms and Documents (consents, questionnaires, attachments)

The SimplePractice Integration Challenge

Practices rely on SimplePractice daily, but turning portal-based workflows into automated pipelines can be hard:

  • Limited public API: Historically, customers have requested a formal API and webhooks for appointments, intakes, payments, and documentation events
  • Portal-first design: Key scheduling, intake, and documentation steps live in web UIs and batch exports rather than unified, documented endpoints
  • Strong security controls: MFA/2FA and session protections complicate headless automation and long-lived integrations
  • Clinical note constraints: Note locking, signatures, and audit trails must be preserved; edits may be restricted post-lock to stay compliant
  • Calendar and telehealth nuances: Two-way calendar sync and ephemeral telehealth links require careful session handling
  • Billing pipelines: Claim submission windows, payer-specific rules, and batch ERA retrieval introduce timing and formatting complexity

How Supergood Creates SimplePractice APIs

Supergood reverse-engineers authenticated browser flows, batch interfaces, and network interactions to deliver a resilient API endpoint layer for SimplePractice.

  • Handles username/password and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes client, appointment, intake, note, and claim objects for consistent integration
  • Aligns with your entitlements and licensing to ensure compliant access
  • Bridges exports/attachments where applicable with signed URL retrieval and delivery

Use SimplePractice with AI agents: SimplePractice MCP Server →

Getting Started

  • Schedule Integration Assessment

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

  • Supergood Builds and Validates Your API

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

  • Deploy with Monitoring

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

simplepractice

Use Cases

CRM and Marketing Automation

- Push new lead-to-client conversions from your CRM into SimplePractice - Trigger outreach when an intake is completed but the first appointment isn’t scheduled - Measure conversion from portal booking to completed intake to first session

Scheduling and Telehealth Orchestration

- Create, update, and cancel appointments from your scheduling layer - Distribute telehealth links securely and log attendance metadata - Keep external calendars and resource management tools in sync

Intake and Document Sync

- Pull submitted intake packets, consents, and signatures into your DMS - Trigger checklists for missing forms or expiring consents - Feed structured questionnaire responses to outcomes and screening tools

Billing, Claims, and Reconciliation

- Build 837P claims from completed sessions with appropriate CPT/ICD-10 - Monitor claim statuses and post ERAs to accounting automatically - Alert on denials and automate corrected claims where policy allows

Analytics and Outcomes

- Centralize operations KPIs: no-shows, utilization, charges, collections - Link outcome measures to visit cadence and care pathways - Attribute revenue to referral sources and campaigns

Technical Specifications

Authentication

Username/password with MFA (SMS, email, TOTP); 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 clients, appointments, intake artifacts, and claim statuses

Security

Encrypted transport, scoped tokens, and audit logging; respects SimplePractice roles/permissions and HIPAA considerations

Webhooks

Optional asynchronous delivery for appointment, intake, and claim status events

Latency

Sub-second responses for list/detail queries under normal load

Throughput

Designed for high-volume scheduling 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 SimplePractice areas, subject to your entitlements: clients, scheduling/telehealth, intake/document retrieval, clinical note metadata, payments, and insurance claims. Exact coverage is finalized during integration assessment.

We handle username/password + MFA (SMS, email, TOTP). For documents, we generate signed URLs, respect expiration windows, and preserve audit and signature context.

Where your permissions allow, we can create progress notes tied to appointments and apply locks/signatures consistent with audit requirements. Some organizations prefer read-only metadata access to notes; we support both patterns depending on policy.

Yes. We can orchestrate two-way calendar syncs and accounting flows while using SimplePractice as the clinical source of truth, pushing financial summaries to tools like QuickBooks/Xero and syncing availability with Google Calendar where permitted.

Ready to get a real API?