WebABA

Supergood | WebABA API

Alex Klarfeld

Alex Klarfeld

— 6 min read
Supergood | WebABA API

Programmatically access client rosters, scheduling, ABA session documentation, payer authorizations, and insurance billing in WebABA with a stable REST API. Supergood builds and operates production-grade, unofficial WebABA integrations so your team can automate clinical and revenue workflows without heavy custom engineering.

In plain English: WebABA is practice management and EHR software used by ABA therapy organizations to schedule sessions, document care, track authorizations, and bill insurance. An unofficial API would let you sync clients and staff from your systems, create and update sessions with correct CPT codes and supervision metadata, validate authorizations, and assemble claims—end to end—without manual portal work.

If you’re a tech company integrating with WebABA, you could pull clinical and billing data (clients, sessions, notes, authorizations, payers, claims) and push updates (new clients, scheduled appointments, session documentation, claim submissions). That enables features like authorization-aware scheduling, real-time timesheet workflows, programmatic note completion checks, automated 837P claims generation, and payment reconciliation using ERA data.

WebABA users often ask for better integrations and data access. Common complaints include the lack of a public API, limited automated exports for sessions and authorizations, manual claim status checks, and friction updating supervision data or bulk authorizations. A Supergood-delivered API addresses these gaps by exposing normalized endpoints tailored to the way ABA agencies actually operate.

What is WebABA?

WebABA provides EHR and practice management software for Applied Behavior Analysis (ABA) therapy practices. It supports client intake, scheduling and appointments, session documentation and progress notes, payer authorization tracking, and insurance billing (including generation of 837P claims and reconciliation with 835 remittances). Organizations use WebABA to manage RBTs and BCBAs, capture supervision and treatment plan details, and coordinate payer policies and compliance.

Core product areas include:

  • Scheduling and appointment management
  • Client records, guardians, payers, and policies
  • ABA session documentation (CPT codes such as 97151, 97153, 97155, 97156, 97158) and progress notes
  • Payer authorizations (units, date ranges, service codes, place of service)
  • Timesheets, supervision tracking (BCBA/RBT)
  • Claims generation and submission; remittance reconciliation
  • Telehealth flags and client portal workflows

Common data entities:

  • Clients (demographics, guardians, diagnoses, payers)
  • Staff (BCBAs, RBTs, schedulers, billing role)
  • Appointments/Sessions (start/end, CPT code, units, POS, telehealth, supervision)
  • Authorizations (service code, units authorized/remaining, validity dates, payer)
  • Treatment plans and progress notes
  • Payers and policies
  • Claims (837P service lines referencing documented sessions)
  • Remittances (835 summaries for reconciliation)

The WebABA Integration Challenge

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

  • Authorization nuances: Units are often in 15-minute increments per CPT code with date range limits; keeping them in sync manually is error-prone
  • Supervision requirements: BCBA supervision minutes and rendering provider roles must be captured accurately for compliance and billing
  • Limited public APIs: Key scheduling, note completion, and claim status workflows live in web apps and batch exports rather than unified APIs
  • Clearinghouse dependencies: EDI submission windows, payer-specific formatting, and ERA retrieval workflows add timing and delivery constraints
  • Security practices: MFA/SSO and role entitlements complicate headless automation for large agencies
  • Reporting exports: CSV-centric reporting makes programmatic, near real-time data access challenging

How Supergood Creates WebABA 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, authorization, session, and claim objects so you can integrate once across payer policies
  • Aligns with customer entitlements and licensing constraints to ensure compliant access
  • Bridges batch exports and SFTP/EDI flows where applicable with signed URL retrieval and delivery

Use Cases

EHR-to-Practice Synchronization

  • Push clients and staff rosters from your HRIS/EHR into WebABA
  • Create appointments automatically from your scheduling system with correct CPT codes, modifiers, and place of service
  • Maintain a single source of truth for demographics, guardians, and payer policies

Authorization-Aware Scheduling and Eligibility

  • Validate authorizations before scheduling or session creation
  • Track remaining units and prevent over-utilization by CPT code and modifier
  • Surface payer rules (POS, telehealth flags, supervision requirements) to coordinators

Session Documentation and Supervision Tracking

  • Pull draft and completed notes to ensure sessions meet payer documentation standards
  • Enforce supervision minute capture for RBT sessions with BCBA oversight
  • Route missing elements (signatures, goals, treatment plan linkage) for correction before billing

Claims Generation and Reimbursement Automation

  • Bundle documented sessions into 837P claims with payer-specific formatting
  • Submit via the configured clearinghouse or portal and track statuses
  • Reconcile remittances (835) alongside session and authorization evidence

Audit and Compliance

  • Export complete session packets with timestamps, CPT codes, supervision, and signatures
  • Maintain machine-readable audit trails aligned to payer requirements
  • Prove claim provenance and documentation coverage during reviews

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_29b71a",
    "name": "Practice Admin",
    "entitlements": ["clients", "authorizations", "sessions", "claims"]
  }
}

Clients

GET /clients: Retrieve ABA client profiles with demographics, guardians, payer policies, and diagnosis codes. Use this to synchronize rosters and drive scheduling.

Query parameters

  • externalId: string
  • name: string (search by first/last)
  • updatedSince: ISO 8601 datetime
  • status: string (active, inactive)

Example response

{
  "items": [
    {
      "clientId": "cli_41cf92",
      "firstName": "Ava",
      "lastName": "Nguyen",
      "dob": "2015-07-21",
      "gender": "female",
      "status": "active",
      "diagnoses": ["F84.0"],
      "primaryPayerId": "payer_bcbs-il",
      "policyNumber": "XZ1234567",
      "guardians": [
        {
          "name": "Linh Nguyen",
          "relationship": "mother",
          "phone": "+1-312-555-0104",
          "email": "[email protected]"
        }
      ],
      "addresses": [
        {
          "type": "home",
          "line1": "2200 W Addison St",
          "city": "Chicago",
          "region": "IL",
          "postalCode": "60618"
        }
      ],
      "externalId": "ehr-12345",
      "updatedAt": "2026-01-21T16:49:12Z"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Authorizations

GET /authorizations: Retrieve payer authorizations by client and CPT code with allowed units, date ranges, and place of service. Use this to validate scheduling and billable session creation.

Query parameters

  • clientId: string
  • payerId: string
  • serviceCode: string (CPT)
  • activeOn: ISO 8601 date

Example response

{
  "items": [
    {
      "authorizationId": "auth_7342c1",
      "authorizationNumber": "AUTH-2026-00117",
      "clientId": "cli_41cf92",
      "clientName": "Ava Nguyen",
      "payerId": "payer_bcbs-il",
      "serviceCode": "97153",
      "modifiers": ["HM"],
      "unitsAuthorized": 480,
      "unitsRemaining": 300,
      "startDate": "2026-01-01",
      "endDate": "2026-03-31",
      "placeOfService": ["11", "12", "02"],
      "status": "active"
    }
  ],
  "page": 1,
  "pageSize": 50,
  "total": 1
}

Sessions

POST /sessions: Create or update an ABA therapy session record with start/end times, CPT service details, telehealth and POS metadata, supervision, and documentation status. Supports compliant edits and note references.

curl --request POST \
  --url https://api.supergood.ai/integrations/<integration_id>/sessions \
  --header 'Authorization: Bearer <authToken>' \
  --header 'Content-Type: application/json' \
  --data '{
    "clientId": "cli_41cf92",
    "renderingProviderId": "prv_rbt_2208aa",
    "supervisorId": "prv_bcba_11d9e2",
    "authorizationId": "auth_7342c1",
    "payerId": "payer_bcbs-il",
    "serviceCode": "97153",
    "modifiers": ["HM"],
    "placeOfService": "12",
    "telehealth": false,
    "startTime": "2026-01-19T14:02:33Z",
    "endTime": "2026-01-19T15:02:33Z",
    "units": 4,
    "diagnosisCodes": ["F84.0"],
    "supervision": {"minutes": 15},
    "goals": ["functional_communication", "task_transition"],
    "notes": "Observed progress in mand training; reduced prompts.",
    "documentation": {"status": "complete", "noteId": "note_991caa"},
    "referenceId": "ehr-schedule-42391"
  }'

Example response

{
  "sessionId": "ses_58d3e0",
  "status": "documented",
  "billableUnits": 4,
  "warnings": [],
  "createdAt": "2026-01-19T15:02:02Z",
  "referenceId": "ehr-schedule-42391"
}

Claims

POST /claims: Assemble an 837P claim from documented sessions. 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",
    "payerId": "payer_bcbs-il",
    "billingProvider": {
      "npi": "1234567890",
      "taxonomy": "Behavior Analyst",
      "name": "BrightPath ABA Services",
      "billingAddress": {
        "line1": "100 Care Way",
        "city": "Chicago",
        "region": "IL",
        "postalCode": "60618"
      }
    },
    "renderingProvider": {"npi": "1098765432"},
    "sessions": [
      {
        "sessionId": "ses_58d3e0",
        "units": 4,
        "serviceCode": "97153",
        "modifiers": ["HM"],
        "placeOfService": "12",
        "diagnosisCodes": ["F84.0"]
      }
    ],
    "submissionChannel": "clearinghouse",
    "referenceId": "billing-batch-jan19"
  }'

Example response

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

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 clients, authorizations, sessions, and claim artifacts
  • Security: Encrypted transport, scoped tokens, and audit logging; respects WebABA entitlements and compliance requirements
  • Webhooks: Optional asynchronous delivery for session documentation status, claim generation, and remittance updates

Performance Characteristics

  • Latency: Sub-second responses for list/detail queries under normal load
  • Throughput: Designed for high-volume scheduling, session documentation, 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 WebABA product mix, licensing, and authentication model.

  1. Supergood Builds and Validates Your API

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

  1. Deploy with Monitoring

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

Schedule Integration Call →

Frequently Asked Questions

Q: Which WebABA product areas can this integration cover?

Supergood supports commonly used WebABA practice management and EHR workflows, subject to your licensing and entitlements. We scope coverage (e.g., clients, scheduling, session documentation, authorizations, claim assembly and submission, remittance retrieval) during integration assessment.

Q: How are MFA, SSO, and clearinghouse interfaces handled for automation?

We support username/password + MFA (SMS, email, TOTP) and can operate behind SSO/OAuth when enabled. For billing flows, we manage EDI timing windows, generate 837 files, and retrieve signed URLs or delivery confirmations programmatically.

Q: Can I generate claims directly from documented sessions?

Yes. You can assemble 837P from documented sessions with payer-specific formatting. We can route submissions via your configured channel (clearinghouse or payer portal) and return statuses and artifacts for reconciliation.

Ready to automate your WebABA workflows?

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

Get Started →

Read more