athenaOne documentation 2026: Marketplace AI scribes, FHIR API, copy-paste workflows, and human-reviewed transcripts

May 8, 2026 · 7 min read

athenaOne is the dominant ambulatory EHR for independent and small-group practices in the US, with 200,000+ providers using the platform in 2026. For an Athena practice considering an AI medical scribe, the integration question is the same as the EHR-choice question: which way of getting AI-generated notes into the chart actually fits the workflow without breaking it?

There are four distinct integration paths in 2026. Each has a different cost, a different setup time, and a different trade-off between EHR-native experience and clinician-controlled DIY workflow.

Path 1 — athenahealth Marketplace partners

Athena's Marketplace lists vetted AI scribe vendors with native integration. Common 2026 entries include Suki, Abridge, DAX Copilot (Microsoft), Heidi, and Tali AI. Marketplace integration means:

• OAuth-based connection — clinician authorizes the vendor once
• Notes flow back to athenaOne via the documentation pipeline
• Encounter context (patient ID, problem list, meds) is auto-pulled by the vendor app
• HIPAA BAA already in place between Athena and the marketplace partner
• Clinician sees AI-generated note as a draft inside athenaOne, not in a third-party app

Cost: vendor pricing applies. Suki and DAX Copilot run $200-300/provider/month. Heidi and Tali AI lower-tier. Abridge enterprise contract.

Time-to-deploy: 1-2 weeks (mostly contracting). Workflow risk: low. Clinician control: low (vendor controls prompt, retention, model selection).

Path 2 — FHIR API direct integration

athenaOne exposes a robust FHIR R4 API. With API credentials, you can:

• Pull patient demographics, problem list, medication list, recent labs
• POST DocumentReference for finished notes
• POST Encounter resources to mark encounter completion
• Authenticate via OAuth 2.0 + SMART on FHIR for clinician-context apps

This path lets a small practice or a developer-led group build their own scribe with full prompt control and full data residency. The build is 4-8 weeks of developer time for a working prototype.

Cost: developer time + LLM costs ($0.50-1.00 per encounter for the prompt pass, plus $0.05/min for transcription). For a 5-provider practice, the all-in cost lands around $30-60/provider/month vs $200-300 for vendor.

Time-to-deploy: 6-10 weeks. Workflow risk: medium (you maintain it). Clinician control: maximum.

Path 3 — Embedded ambient (athenaOne native)

athenaOne ships with an increasingly capable native ambient experience in 2026 (the Athena ambient feature set has expanded since 2024). For practices that don't want a third-party vendor, the native option:

• Records visit audio in the athenaOne mobile app
• Generates draft note via Athena's AI service
• Note appears as draft in encounter, requires clinician sign-off
• No additional vendor BAA required — Athena handles end-to-end

Cost: bundled or premium add-on tier (per Athena pricing schedule, typically a percentage uplift on the per-encounter fee).

Time-to-deploy: hours (it's already in your tenant if your subscription includes it). Workflow risk: minimal. Clinician control: low (Athena's prompt, Athena's model).

Path 4 — DIY copy-paste from external transcription

Lessrec provides human-reviewed transcription: an editor listens to the recording and checks the full text. Send your project requirements for an individual written quote.

• No EHR integration work
• Clinician chooses the LLM, the prompt, the retention policy
• BAA chain managed by clinician (transcription vendor, Anthropic/OpenAI Enterprise for LLM)
• Cost: lowest of the four paths — $30-90/provider/month all-in

The downside: no encounter context auto-population, copy-paste friction, harder to enforce documentation standards across multiple providers in the same practice.

Time-to-deploy: hours. Workflow risk: low (copy-paste only). Clinician control: maximum.

The four paths compared

Specialty considerations

If your practice is on Athena and serves a specialty with high vocabulary specificity (cardiology, OB, pediatrics, orthopedics), the FHIR API path or DIY path tend to win. The Marketplace partners ship with general specialty templates, but custom prompt control via FHIR API or DIY lets you build the specialty-aware schema we cover in our specialty guides.

If your practice is FQHC or RHC on athenaOne FQHC, the DIY path with UDS-aware prompt is structurally important — FQHC reporting requirements aren't well-served by general scribe templates.

The Athena FHIR endpoint reality

Athena's FHIR endpoint requires:

• OAuth 2.0 client credentials registered with athenahealth developer portal
• SMART on FHIR launch context for clinician-attached apps
• Practice-level authorization (every athenaOne practice that uses your app must connect)
• Rate limits per practice (typically 10 req/sec, 1000 req/min — check current limits)

For a single-practice deployment of a custom AI scribe, the OAuth + SMART setup is one developer-day. For a multi-practice deployment (you're building a vendor app), the Marketplace partner program is the more durable path.

BAA considerations on Athena

Athena's standard BAA covers data within the athenaOne platform. The moment audio leaves athenaOne (recorded by an external app, sent to an external transcription service), you need:

• Your own BAA with the recording app vendor (or self-recorded audio with no vendor handling)
• Your own BAA with the transcription service (confirm availability with each vendor)
• Your own BAA with the LLM vendor (Anthropic Enterprise, OpenAI Enterprise both offer)
• Documented retention policy for audio + transcript + intermediate outputs

The Marketplace partner path simplifies the BAA chain (Athena BAA + vendor BAA covers the chain). The DIY path requires the practice to manage 2-3 BAAs.

When each path wins in 2026

What's coming in 2026 H2

athenahealth's roadmap suggests deeper native ambient AI through 2026 H2, potentially closing the gap with third-party scribes for general primary care. For specialty workflows and cost-sensitive solo practices, the DIY and FHIR API paths will remain structurally cheaper through 2027.