SimplePractice

Supergood | Simple Practice API

Alex Klarfeld

Alex Klarfeld

— 6 min read

SimplePractice is practice management and EHR software for health and wellness providers—especially mental and behavioral health clinicians. It covers scheduling, telehealth, documentation, client intake, billing, and insurance claims. With an unofficial API, you could securely pull and push client records, appointments, telehealth sessions, invoices, and claims so your systems stay in sync without manual data entry.

If you’re a tech company integrating with SimplePractice, an API unlocks concrete workflows: importing clients from your CRM, automating appointment creation and reminders, generating CMS-1500/837P claims from sessions, reconciling client payments and insurance remittances, and exporting documentation or superbills into your data lake or analytics stack.

Programmatically access scheduling, client portal, billing, and insurance workflows in SimplePractice with a stable REST API. Supergood builds and operates production-grade, unofficial SimplePractice integrations so your team can automate critical intake, scheduling, documentation, and revenue cycle pipelines without heavy custom engineering.

SimplePractice is software used by solo and group practices to streamline the end-to-end patient journey—from online booking and intake forms to telehealth visits, progress notes, invoicing, and insurance reimbursement. With an unofficial API, you could synchronize client rosters, create appointments with telehealth links, post payments, assemble and submit claims, and export ERA/EOB artifacts for reconciliation.

If you’re a clinic, provider group, or revenue cycle team, integrating your tech stack with SimplePractice unlocks concrete data flows and features:

  • Pull: Client profiles, clinicians, appointments, telehealth session links, insurance details, invoices/superbills, claim statuses, ERAs/EOB summaries
  • Push: New/updated clients from your CRM, scheduled appointments, progress note associations, invoice creation, payment capture, claims built from recorded sessions
  • Build: Intake-to-schedule automation, appointment reminders, documentation exports, automatic CMS-1500/837P assembly, reconciliation dashboards driven by payments and remittances

What is SimplePractice?

SimplePractice provides practice management and EHR tools for private practices across behavioral health, psychotherapy, counseling, coaching, physical therapy, speech therapy, and other allied health specialties. Core capabilities include online booking, calendar management, telehealth, client portal, paperless intake, clinical documentation (SOAP/progress notes), billing, payment processing, and insurance claim submission.

Core product areas include:

  • Scheduling and calendar management (with online booking and reminders)
  • Telehealth (HIPAA-compliant video sessions)
  • Client portal, intake packets, consent forms, and secure messaging
  • EHR documentation (progress notes, treatment plans, templates)
  • Billing and payment processing (client invoices, superbills, cards on file)
  • Insurance workflows (payer details, CMS-1500/837P, ERA/EOB)

Common data entities:

  • Clients (demographics, contacts, portal status, insurance)
  • Clinicians (NPI, taxonomy, licensure, availability)
  • Appointments (service codes/CPT, location, telehealth, status)
  • Notes and documentation (progress, diagnosis, treatment plan)
  • Invoices and superbills (line items, balances, payments)
  • Claims (CMS-1500/837P, status, payer responses)
  • Payments (client payments via card/ACH, refunds)
  • Remittances (ERAs, adjudication results)

The SimplePractice Integration Challenge

Organizations rely on SimplePractice daily, but turning portal-first workflows into automated pipelines is hard:

  • No official public API: Users frequently ask for integrations and API access; most data lives behind web apps and exports
  • Strong security and MFA: Two-factor authentication and role-based access complicate headless automation
  • Portal-first delivery: Scheduling, documentation, claims, and ERA retrieval are designed for UI workflows and batch exports
  • Data interfaces and timing windows: CSV exports, clearinghouse submissions, and ERA availability follow processing windows
  • Documentation artifacts: Notes and attached documents require careful export with audit trails and permissions
  • Calendar sync nuances: ICS/Google Calendar integrations may not expose all metadata (e.g., CPT, telehealth links)

How Supergood Creates SimplePractice APIs

Supergood reverse-engineers authenticated browser flows and batch interfaces to deliver a resilient API endpoint layer.

  • Handles username/password and MFA (SMS, email, TOTP) securely
  • Maintains session continuity with automated refresh and change detection
  • Normalizes client, appointment, billing, and claim objects so you can integrate once across practice configurations
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges exports and clearinghouse flows where applicable with signed URL retrieval and delivery

Use Cases

Intake-to-Schedule Automation

  • Push clients from your CRM into SimplePractice with intake packets
  • Create appointments tied to CPT codes and telehealth links
  • Keep demographics, consent, and portal access in sync

Documentation and Telehealth Operations

  • Attach progress notes to appointments and export summaries
  • Generate telehealth session links and reminders programmatically
  • Track appointment statuses (scheduled, completed, no-show, canceled)

Billing and Insurance Automation

  • Build invoices and superbills from recorded sessions
  • Assemble CMS-1500/837P claims with provider and payer details
  • Retrieve claim statuses and ERAs/EOBs for reconciliation

Payment Capture and Reconciliation

  • Post client payments from cards on file
  • Match remittances to claims and update balances
  • Surface aging and write-offs to finance teams

Audit and Compliance

  • Export machine-readable artifacts: intake forms, notes, claim packets
  • Maintain audit trails for edits, cancellations, and refunds
  • Prove documentation and billing provenance during reviews

Available Endpoints

Authentication

POST /sessions: Establish a session using credentials. Supergood manages MFA (SMS, email, TOTP) 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_29b71a",
    "name": "Office Admin",
    "entitlements": ["clients", "appointments", "billing", "claims"]
  }
}

Clients

GET /clients: Retrieve client profiles with demographics, contact info, insurance details, and portal status. Use filters to target subsets for onboarding or billing.

Query parameters

  • email: string
  • phone: string (E.164)
  • status: string (active, inactive)
  • clinicianId: string
  • createdSince: ISO 8601 timestamp

Example response

{
  "items": [
    {
      "clientId": "cl_9b42f0",
      "firstName": "Jordan",
      "lastName": "Patel",
      "dateOfBirth": "1991-04-12",
      "email": "[email protected]",
      "phone": "+15551234567",
      "address": {
        "line1": "100 Practice Way",
        "city": "Portland",
        "region": "OR",
        "postalCode": "97205"
      },
      "portalStatus": "invited",
      "primaryInsurance": {
        "payerName": "Aetna",
        "memberId": "AET-5583201",
        "groupNumber": "GRP-10012"
      },
      "clinicianId": "prv_41cf92",
      "tags": ["telehealth", "weekly"]
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Appointments

POST /appointments: Create or update an appointment with CPT/service code, telehealth link generation, and reminders. Supports cancellation/no-show transitions with audit notes.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/appointments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "clientId": "cl_9b42f0",
    "clinicianId": "prv_41cf92",
    "service": {
      "cpt": "90837",
      "description": "Psychotherapy, 60 minutes",
      "placeOfService": "10"  
    },
    "location": "telehealth",
    "startAt": "2026-01-19T14:00:00Z",
    "endAt": "2026-01-19T15:00:00Z",
    "status": "scheduled",
    "generateTelehealthLink": true,
    "chargeAmount": 160.00,
    "reminders": {
      "email": true,
      "sms": true
    },
    "referenceId": "crm-apt-42391"
  }'

Example response

{
  "appointmentId": "apt_58d3e0",
  "status": "scheduled",
  "telehealth": {
    "link": "https://telehealth.simplepractice.example/session/abc123",
    "expiresAt": "2026-01-19T16:00:00Z"
  },
  "createdAt": "2026-01-19T13:55:12Z",
  "referenceId": "crm-apt-42391"
}

Claims

POST /claims: Assemble a CMS-1500/837P claim from completed appointments. Supergood normalizes service lines and can route the generated file to the configured submission channel (e.g., clearinghouse).

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/claims \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "claimType": "837P",
    "payer": {
      "name": "Aetna",
      "payerId": "00001"
    },
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "101YM0800X",
      "name": "Northwood Behavioral Health",
      "billingAddress": {
        "line1": "200 Wellness Ave",
        "city": "Portland",
        "region": "OR",
        "postalCode": "97205"
      }
    },
    "patient": {
      "clientId": "cl_9b42f0",
      "diagnoses": ["F41.1"]
    },
    "renderingProviderId": "prv_41cf92",
    "serviceLines": [
      {
        "appointmentId": "apt_58d3e0",
        "cpt": "90837",
        "placeOfService": "10",
        "modifiers": [],
        "units": 1,
        "chargeAmount": 160.00
      }
    ],
    "submissionChannel": "clearinghouse",
    "referenceId": "billing-batch-jan19"
  }'

Example response

{
  "claimId": "clm_71af2b",
  "status": "queued",
  "edi": {"format": "837P", "size": 42876},
  "submissionChannel": "clearinghouse",
  "createdAt": "2026-01-19T16:05:42Z",
  "reviewUrl": "https://download.simplepractice.example/signed/abc123...",
  "referenceId": "billing-batch-jan19"
}

Get full API Specs →

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 practice 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, invoices, and claim artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects SimplePractice entitlements and compliance requirements
  • Webhooks: Optional asynchronous delivery for appointment changes, claim generation, and remittance updates

Performance Characteristics

  • 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

Getting Started

  1. Schedule Integration Assessment

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

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which SimplePractice product areas can this integration cover?

Supergood supports workflows across commonly used SimplePractice modules—scheduling, client portal, telehealth, documentation exports, billing/invoices, claims, and ERAs—subject to your licensing and entitlements. We scope coverage during integration assessment.

Q: How are MFA and portal-based flows handled for automation?

We support username/password + MFA (SMS, email, TOTP). For batch flows, we manage submission timing windows, generate CMS-1500/837P, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I generate claims directly from recorded appointments?

Yes. You can assemble CMS-1500/837P from completed appointments with payer-specific formatting. We route submissions via your configured channel (e.g., clearinghouse) and return statuses and artifacts for reconciliation.

Ready to automate your SimplePractice workflows?

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

Get Started →

Read more