SimplePractice

Supergood | SimplePractice API

Alex Klarfeld

Alex Klarfeld

— 6 min read

Programmatically access scheduling, client records, intake documents, telehealth links, billing artifacts, and insurance claims in SimplePractice with a stable REST API. Supergood builds and operates production-grade, unofficial SimplePractice integrations so your team can automate critical practice management and revenue operations without heavy custom engineering.

SimplePractice is practice management software used by behavioral health and allied health clinicians to run their practices end to end—scheduling and telehealth, client intake and documentation, secure messaging and client portal, payments, and insurance billing. With an unofficial API, you could synchronize client rosters, automate appointment creation, pull notes metadata and intake packets, generate superbills or claims, and reconcile payments and statuses across systems.

If you’re a digital health vendor, EHR, billing service, or multi-location group practice, integrating your stack with SimplePractice unlocks concrete data flows and features:

  • Pull: Client demographics and insurance, clinician rosters, appointment schedules, telehealth session links, intake forms (PDF/JSON), invoices and payments, superbills, claim statuses, ERA/EOB summaries
  • Push: New/updated clients and clinicians, scheduled sessions with CPT codes, document uploads, charge capture and line items, claim submissions (837P or CMS-1500), portal invites and reminders
  • Build: Two-way scheduling, authorization-aware charge capture, telehealth check-in workflows, multi-site reporting, automated claim assembly and payment reconciliation

What is SimplePractice?

SimplePractice provides an all-in-one practice management platform for solo and group practices, with a strong footprint in mental and behavioral health. Core modules cover online booking, calendar and reminders, paperless intake and eSign, documentation (progress notes, treatment plans), integrated telehealth, client portal and messaging, payments, and insurance billing via clearinghouse connections.

Core product areas include:

  • Scheduling and calendar management (availability, reminders, no-show/late-cancel policies)
  • Client intake and portal (consent forms, questionnaires, electronic signatures)
  • Documentation (progress notes, treatment plans, diagnosis codes)
  • Telehealth sessions (HIPAA-compliant video, session links)
  • Billing (invoices, superbills, credits, client payments)
  • Insurance (payer enrollment, claims, ERA/EOB reconciliation)
  • Reporting for productivity, financials, and caseloads

Common data entities:

  • Clients (demographics, contacts, insurance policies, portal status)
  • Clinicians/Team (roles, permissions, availability)
  • Appointments (service CPT, date/time, location/telehealth, status)
  • Documents (intake packets, signed consents, uploaded files)
  • Notes (progress notes metadata, diagnoses, treatment plans)
  • Invoices and payments (card-on-file, refunds, adjustments)
  • Superbills and claims (837P/CMS-1500, status, denial reasons)
  • Payers/Insurance (payer IDs, subscriber/member info)

The SimplePractice Integration Challenge

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

  • No public API: Many users report the lack of a documented, supported API or webhooks, limiting real-time integrations to CSV exports and manual processes
  • Authentication and MFA: 2-step verification and session controls complicate headless automation and session continuity
  • Telehealth/link access: Generating and distributing session links programmatically or capturing attendance requires careful handling of session lifecycle events
  • Insurance complexity: Eligibility, claims, and ERA/EOB statuses often live behind portal views or batch exports, with payer-specific rules and timing windows
  • Data portability: Intake packets and signed forms are typically retrieved as PDFs; bulk export, filtering, and lineage for audit trails require orchestration
  • Calendar and reminders: Two-way sync with external calendars (e.g., Google/Outlook) and reminder customizations are frequent requests that need robust adapters

How Supergood Creates SimplePractice 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, document, billing, and claims objects across account types
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges batch exports, document downloads, and clearinghouse artifacts with signed URL retrieval and delivery

Use Cases

EHR-to-Practice Management Synchronization

  • Push client and clinician rosters from your system of record into SimplePractice
  • Create and update appointments with correct CPT codes and locations (office or telehealth)
  • Keep demographics, insurance, and portal status in sync

Revenue Cycle Automation

  • Generate invoices and superbills from scheduled appointments and captured charges
  • Assemble and submit claims (837P/CMS-1500) and retrieve clearinghouse statuses
  • Reconcile payments and ERA/EOBs back to your ledger with audit trails

Client Engagement and Telehealth

  • Provision intake packets and collect eSignatures programmatically
  • Distribute telehealth links, manage waiting rooms, and confirm attendance
  • Trigger reminders and portal invites based on lifecycle events

Compliance and Reporting

  • Export signed forms, notes metadata, and claim artifacts for audits
  • Maintain machine-readable logs of edits and submission history
  • Build productivity and financial dashboards across locations and providers

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_c1in1c",
    "name": "Practice Admin",
    "entitlements": ["clients", "appointments", "billing", "documents"]
  }
}

Clients

GET /clients: Retrieve client demographics, insurance, portal status, and assigned clinician. Use filters to drive syncing and eligibility checks.

Query parameters

  • search: string (name, email, phone)
  • updatedSince: ISO 8601 datetime
  • status: enum [active, inactive, archived]
  • clinicianId: string
  • page: number
  • pageSize: number

Example response

{
  "items": [
    {
      "clientId": "cl_7a92f1",
      "fullName": "Avery Johnson",
      "dateOfBirth": "1990-05-14",
      "gender": "female",
      "emails": ["[email protected]"],
      "phones": [{"type": "mobile", "number": "+1-310-555-0134"}],
      "address": {
        "line1": "101 Ocean Ave",
        "city": "Santa Monica",
        "region": "CA",
        "postalCode": "90401"
      },
      "primaryClinicianId": "pr_5140a9",
      "insurance": {
        "payerId": "payer_blue",
        "planName": "Blue PPO",
        "memberId": "M1234567",
        "groupNumber": "GRP-8821"
      },
      "diagnoses": ["F41.1"],
      "portalEnabled": true,
      "status": "active",
      "updatedAt": "2026-01-22T18:44:10Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Appointments

POST /appointments: Create a scheduled appointment with service details, reminders, and optional telehealth. Supports idempotency via referenceId.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/appointments \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "clientId": "cl_7a92f1",
    "clinicianId": "pr_5140a9",
    "cptCode": "90834",
    "modifiers": [],
    "startAt": "2026-02-01T17:00:00Z",
    "endAt": "2026-02-01T17:45:00Z",
    "location": {
      "type": "telehealth",
      "officeId": null
    },
    "sendReminders": true,
    "notes": "Initial evaluation follow-up.",
    "referenceId": "ehr-appt-49231"
  }'

Example response

{
  "appointmentId": "ap_2f91d0",
  "status": "scheduled",
  "telehealth": {
    "enabled": true,
    "joinUrl": "https://video.simplepractice.example/session/abc123",
    "startAt": "2026-02-01T17:00:00Z"
  },
  "referenceId": "ehr-appt-49231",
  "createdAt": "2026-01-23T16:12:05Z"
}

Claims

POST /claims: Assemble an 837P or CMS-1500 claim from billable appointments or charges. Supergood normalizes service lines and can route the generated file to the configured submission channel.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/claims \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "claimType": "837P",
    "patientId": "cl_7a92f1",
    "subscriber": {
      "payerId": "payer_blue",
      "memberId": "M1234567",
      "relationship": "self"
    },
    "billingProvider": {
      "npi": "1234567890",
      "name": "Harbor Wellness Group",
      "taxonomy": "Behavioral Health",
      "billingAddress": {
        "line1": "500 Harbor Way",
        "city": "Los Angeles",
        "region": "CA",
        "postalCode": "90001"
      }
    },
    "serviceLines": [
      {
        "dateOfService": "2026-02-01",
        "cptCode": "90834",
        "modifiers": [],
        "diagnosisCodes": ["F41.1"],
        "chargeAmount": 140.0,
        "units": 1,
        "placeOfService": "11",
        "appointmentId": "ap_2f91d0"
      }
    ],
    "submissionChannel": "clearinghouse",
    "referenceId": "rcm-batch-0201"
  }'

Example response

{
  "claimId": "clm_71b2c9",
  "status": "queued",
  "edi": {"format": "837P", "size": 28412},
  "submissionChannel": "clearinghouse",
  "createdAt": "2026-02-01T18:05:42Z",
  "trackingNumber": "TRK-552199",
  "referenceId": "rcm-batch-0201"
}

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 schedules, documents, and billing artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects SimplePractice roles and compliance requirements
  • Webhooks: Optional asynchronous delivery for appointment changes, intake completions, claim updates, and payment events

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume scheduling and batch claims 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 areas can this integration cover?

Supergood supports workflows across commonly used SimplePractice modules—clients, scheduling, intake documents, telehealth links, invoices/superbills, and claims—subject to your licensing and entitlements. We confirm exact scope during integration assessment.

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. Telehealth sessions are created via authenticated flows; we return session metadata (e.g., join URLs and timing) in a secure, time-bound manner.

Q: Can I submit insurance claims or only export them?

Both are possible. You can generate 837P/CMS-1500 from scheduled services and either route them to your configured clearinghouse or retrieve signed files for submission via your existing channel. Statuses and ERA/EOB artifacts can be polled or delivered via webhooks.

Ready to automate your SimplePractice workflows?

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

Get Started →

Read more