Skip to main content
POST
Practice
Practice management (via NexHealth) reaches Dentrix, Eaglesoft, Open Dental, Curve, Denticon, athenaOne and eClinicalWorks. Epic reaches hospitals and health systems over FHIR R4; see Epic.

Connect

Authorize OneShot in NexHealth. In console Connections, choose Practice management (via NexHealth), select your practice system and enter its subdomain and location ID. Equivalent POST /v1/connections:
To change practices, revoke and start again. HIPAA organizations need nexhealth approved under their compliance policy.

Reads

Every tool takes connection_id, limit (1 to 100, default 25) and optional cursor. Pass next_cursor with unchanged filters, including after empty pages. Missing fields are null. Both windows are required, positive, ISO 8601 with timezone, start-inclusive and end-exclusive. Appointments allow 31 days; openings allow 14. Completed means checked out, not simply past. due_for_recall means before today in UTC. Pages hold at most one patient. last_visit and next_appointment are always null; use appointment reads.

Treatment plans

updated_at means plan update time; start_date/end_date mean procedure dates. updated_since is inclusive. plan_id retains filters.

Privacy and payment

Read records are inline, untrusted and never saved, including goal results. Logs and receipts contain identifiers and counts only. Foreign, revoked, expired and compliance-refused connections are rejected before payment. Failed paid reads return account credit. See Pricing.

Book an appointment

POST /v1/tools/practice/appointments/book (practice_appointments_book) waits for approval unless the agent’s policy allows it. Send Idempotency-Key with:
Optional operatory identifies the room; note allows 500 characters. Retry approved requests unchanged with X-Approval-Id. Availability is rechecked before writing. slot_taken writes nothing. Repeated keys return the recorded outcome. write_outcome_unknown is never retried: check the schedule before booking again. Returns { id, starts_at, ends_at, provider, status, source: { system, id } }, retained for replay without patient identifiers or note. Booking does not change case state.

Epic

Your Epic team activates the OneShot backend app and sends you the client id Epic issued for it. OneShot records that activation for your organization; until recorded, a start answers not_granted. Then start with that id and your FHIR R4 base URL (https, public host, default port):
HIPAA organizations need epic approved under their compliance policy, after a signed BAA. Identifiers are FHIR ids. due_for_recall answers unsupported_filter; appointment_type_id takes a code or system|code. A booking completes only when Epic answers booked.