eClinicalWorks connector for AI agents

Tools your clinical agent reaches for on eClinicalWorks, scoped per user.

CALL ANY TOOL

77 tools for clinical records in eClinicalWorks over FHIR: read and search patients, encounters, conditions, medications, and observations, add notes, vitals, and diagnoses, place orders and referrals, and manage coverage.

eclinicalworks_allergy_intolerance_create

Create allergy intolerance

Record an allergy or adverse reaction for a patient in eClinicalWorks. The entry lands in the chart's App Data tab, where a clinician reconciles it into the chart. Returns a transaction-response Bundle whose entry[0].response.location holds the new resource's FHIR ID (check entry[0].response.status for eCW error codes). Use eclinicalworks_allergy_intolerance_search to check existing allergies first. eCW requires a signed write contract for this scope.

Parameters

Name

Type

Required

Description

patient_id

string

Required

FHIR logical ID of the patient (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

substance

string

Required

Name of the allergen, shown as the allergy name in eCW. Example: Penicillin.

clinical_status

string

Optional

Allergy status: active or inactive. One of: `active`, `inactive`.

code

string

Optional

Optional code of the allergen (for example a SNOMED or RxNorm code). Example: 764146007.

code_system

string

Optional

Code system URI for code. Example: http://snomed.info/sct or http://www.nlm.nih.gov/research/umls/rxnorm.

criticality

string

Optional

Criticality: high, low or unable-to-assess. One of: `high`, `low`, `unable-to-assess`.

onset_date_time

string

Optional

Date the allergy was identified, as an ISO 8601 date-time with offset. Example: 2026-01-15T10:00:00-05:00.

reaction

string

Optional

Reaction text in eCW's '<reaction type> : <reaction>' format, where the type is Side Effects, Lack of Therapeutic Effect or Contraindication (eCW uses Allergy when no type is given). Example: Contraindication : hives.

eclinicalworks_allergy_intolerance_read

Read allergy intolerance

eclinicalworks_allergy_intolerance_search

Search allergy intolerance

eclinicalworks_care_plan_read

Read care plan

eclinicalworks_care_team_search

Search care team

eclinicalworks_condition_create

Create condition

Add a diagnosis to a patient's Problem List or to the Assessments (encounter diagnosis) section in eClinicalWorks. The entry lands in the chart's App Data tab, where a clinician reconciles it into the chart. Returns a transaction-response Bundle whose entry[0].response.location holds the new resource's FHIR ID (check entry[0].response.status for eCW error codes). Clinical status, verification status, abatement date and note apply to problem-list entries only. eCW requires a signed write contract for this scope.

Parameters

Name

Type

Required

Description

category

string

Required

Where to add the diagnosis: problem-list-item (Problem List) or encounter-diagnosis (Assessments). One of: `problem-list-item`, `encounter-diagnosis`.

code

string

Required

Diagnosis code. eCW prefers ICD-10-CM, then SNOMED CT. Example: E11.9.

code_system

string

Required

Code system of code: http://hl7.org/fhir/sid/icd-10-cm or http://snomed.info/sct. One of: `http://hl7.org/fhir/sid/icd-10-cm`, `http://snomed.info/sct`.

patient_id

string

Required

FHIR logical ID of the patient (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

abatement_date_time

string

Optional

Date the problem resolved (required when clinical_status is resolved), as an ISO 8601 date-time with offset. Example: 2026-01-15T10:00:00-05:00.

clinical_status

string

Optional

Problem status: active, resolved, inactive, recurrence or remission. When resolved, also send abatement_date_time. One of: `active`, `resolved`, `inactive`, `recurrence`, `remission`.

code_display

string

Optional

Diagnosis name. Example: Type 2 diabetes mellitus without complications.

note

string

Optional

Note to attach to the diagnosis (problem list only). Example: Diet-controlled.

onset_date_time

string

Optional

Date the diagnosis was recorded, as an ISO 8601 date-time with offset. Example: 2026-01-15T10:00:00-05:00.

verification_status

string

Optional

Verification status: confirmed, provisional, refuted, entered-in-error or differential. One of: `confirmed`, `provisional`, `refuted`, `entered-in-error`, `differential`.

eclinicalworks_coverage_delete

Delete coverage

eclinicalworks_coverage_read

Read coverage

eclinicalworks_coverage_update

Update coverage

Update an insurance policy on a patient's demographics in eClinicalWorks by its Coverage FHIR ID. Returns a transaction-response Bundle; check entry[0].response.status for eCW error codes. Use eclinicalworks_coverage_create to add a new policy. eCW requires a signed write contract for this scope.

Parameters

Name

Type

Required

Description

coverage_id

string

Required

FHIR logical ID of the Coverage (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

patient_id

string

Required

FHIR logical ID of the patient (beneficiary) who holds the insurance (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

payor_id

string

Required

FHIR logical ID of the insurance company (payor Organization) (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

assignment_of_benefits

string

Optional

Assignment of benefits: Y (assigned to provider, eCW default), N (not assigned), O (pay other organization) or W (not applicable). One of: `Y`, `N`, `O`, `W`.

group_name

string

Optional

Group name. Example: Example Employer Plan.

group_number

string

Optional

Group number on the card. Example: GRP001.

member_id

string

Optional

Subscriber (member) number on the insurance card. Example: ABC123456.

order

integer

Optional

Coverage order: 1 primary, 2 secondary, 3 tertiary. One of: `1`, `2`, `3`.

period_end

string

Optional

Coverage end date, as YYYY-MM-DD. Example: 2026-01-15.

period_start

string

Optional

Coverage start date, as YYYY-MM-DD. Example: 2026-01-15.

relationship

string

Optional

Beneficiary's relationship to the subscriber: self, spouse, child, injured (injured plaintiff), other, parent or common (life partner). One of: `self`, `spouse`, `child`, `injured`, `other`, `parent`, `common`.

subscriber_reference

string

Optional

The insured person, as Patient/<FHIR ID> or RelatedPerson/<FHIR ID>. Example: Patient/12345.

type

string

Optional

Insurance type (eCW source of payment): pay, PPO, POS, HIP, HMO, DENTAL, DENTPRG, AUTOPOL, DIS, GOVEMP, VET, WCBPOL. One of: `pay`, `PPO`, `POS`, `HIP`, `HMO`, `DENTAL`, `DENTPRG`, `AUTOPOL`, `DIS`, `GOVEMP`, `VET`, `WCBPOL`.

eclinicalworks_device_search

Search device

eclinicalworks_diagnostic_report_read

Read diagnostic report

eclinicalworks_document_reference_pdf_create

Create document reference pdf

Upload a PDF (base64) to a patient's documents in eClinicalWorks, either to the App Data tab for reconciliation or, when assigned to a reviewer, directly into Patient Documents (and into an encounter if one is given). Returns a transaction-response Bundle whose entry[0].response.location holds the new resource's FHIR ID (check entry[0].response.status for eCW error codes). Ask the practice for the folder name; unknown folders fall back to the practice's default folder (usually Misc). eCW requires a signed write contract for this scope.

Parameters

Name

Type

Required

Description

document_type

string

Required

LOINC document type: 34133-9 (Summary of episode note), 11488-4 (Consultation note), 34117-2 (H & P note), 28570-0 (Procedure note), 11506-3 (Progress note), 18842-5 (Discharge summary). One of: `34133-9`, `11488-4`, `34117-2`, `28570-0`, `11506-3`, `18842-5`.

patient_id

string

Required

FHIR logical ID of the patient (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

pdf_base64

string

Required

Base64-encoded content of the PDF file. Example: JVBERi0xLjQK (truncated).

assign_to_id

string

Optional

FHIR logical ID of the provider or staff member who should review it; when set, the document goes straight into Patient Documents (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

author_id

string

Optional

FHIR logical ID of the provider sending the document (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

description

string

Optional

Description of the document. Example: Consult letter from Dr. Example.

document_name

string

Optional

Name to show for the document. Example: Outside cardiology consult.

encounter_id

string

Optional

FHIR logical ID of the encounter to attach it to (used only with assign_to_id) (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

folder_name

string

Optional

eCW document folder to file it in, confirmed with the practice. Example: Consult Notes.

high_priority

boolean

Optional

Whether to flag the document as high priority.

reviewed

boolean

Optional

Whether the document is already reviewed.

scanned_by_id

string

Optional

FHIR logical ID of the person who scanned the document (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

scanned_date

string

Optional

Date the document was scanned, as YYYY-MM-DD. Example: 2026-01-15.

eclinicalworks_encounter_search

Search encounter

eclinicalworks_family_member_history_read

Read family member history

eclinicalworks_goal_search

Search goal

eclinicalworks_immunization_create

Create immunization

Record a historical immunization (given elsewhere or in the past) for a patient in eClinicalWorks. The entry lands in the chart's App Data tab, where a clinician reconciles it into the chart. Returns a transaction-response Bundle whose entry[0].response.location holds the new resource's FHIR ID (check entry[0].response.status for eCW error codes). Use eclinicalworks_immunization_update to complete or correct an immunization already in the chart. eCW requires a signed write contract for this scope.

Parameters

Name

Type

Required

Description

cvx_code

string

Required

CVX vaccine code. Example: 52 (Hep A, adult).

occurrence_date_time

string

Required

Date the vaccine was given, as an ISO 8601 date-time with offset. Example: 2026-01-15T10:00:00-05:00.

patient_id

string

Required

FHIR logical ID of the patient (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

dose_number

integer

Optional

Dose number in the series, 0 to 20. Example: 1.

dose_unit

string

Optional

UCUM unit of the dose: cL, cm3, g, ug, uL, {millicuries}, mg, mL, ng, {spray}, {units}. One of: `cL`, `cm3`, `g`, `ug`, `uL`, `{millicuries}`, `mg`, `mL`, `ng`, `{spray}`, `{units}`.

dose_value

number

Optional

Dose amount. Example: 0.5.

location_id

string

Optional

FHIR logical ID of the facility where the immunization was documented (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

report_origin

string

Optional

Source of the historical record: provider (other provider), record (written record), recall (parent's recall) or school (school record). One of: `provider`, `record`, `recall`, `school`.

route

string

Optional

Route code: IDINJ (Intradermal), IM (Intramuscular), NASINHL (Nasal), IV (Intravenous), PO (Oral), SQINFUS (Subcutaneous), TRNSDERM (Transdermal). One of: `IDINJ`, `IM`, `NASINHL`, `IV`, `PO`, `SQINFUS`, `TRNSDERM`.

site

string

Optional

Body site code: LT (Left Thigh), LA (Left Arm), LD (Left Deltoid), LG (Left Gluteus Medius), LVL (Left Vastus Lateralis), LLFA (Left Lower Forearm), RT (Right Thigh), RA (Right Arm), RD (Right Deltoid), RG (Right Gluteus Medius), RVL (Right Vastus Lateralis), RLFA (Right Lower Forearm). One of: `LT`, `LA`, `LD`, `LG`, `LVL`, `LLFA`, `RT`, `RA`, `RD`, `RG`, `RVL`, `RLFA`.

vaccine_name

string

Optional

Vaccine name. Example: Hep A, Adult.

eclinicalworks_immunization_update

Update immunization

Update an existing (non-historical) immunization in eClinicalWorks by its FHIR ID, for example to mark it completed with lot, site, route and dose, or not-done with a reason. Returns a transaction-response Bundle; check entry[0].response.status for eCW error codes. When status is completed, eCW requires lot_number, expiration_date, site, route, dose, performer and dose_number; a new lot also needs manufacturer_id and funding_source. eCW requires a signed write contract for this scope.

Parameters

Name

Type

Required

Description

cvx_code

string

Required

CVX vaccine code. Example: 207.

encounter_id

string

Required

FHIR logical ID of the visit where the immunization is documented (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

immunization_id

string

Required

FHIR logical ID of the Immunization (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

occurrence_date_time

string

Required

Date and time the vaccine was given (ignored when status is not-done), as an ISO 8601 date-time with offset. Example: 2026-01-15T10:00:00-05:00.

patient_id

string

Required

FHIR logical ID of the patient (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

status

string

Required

Immunization status: completed, entered-in-error or not-done. One of: `completed`, `entered-in-error`, `not-done`.

dose_number

integer

Optional

Dose number in the series, 0 to 20. Example: 1.

dose_unit

string

Optional

UCUM unit of the dose: cL, cm3, g, ug, uL, {millicuries}, mg, mL, ng, {spray}, {units}. One of: `cL`, `cm3`, `g`, `ug`, `uL`, `{millicuries}`, `mg`, `mL`, `ng`, `{spray}`, `{units}`.

dose_value

number

Optional

Dose amount. Example: 0.5.

expiration_date

string

Optional

Lot expiration date, as YYYY-MM-DD. Example: 2026-01-15.

funding_source

string

Optional

Funding source (needed for a new lot): v (Govt (VFC)), y (Govt (Non VFC)), n (Purchased), u (Unknown), p (Patient Brought In), g (Public Vaccine Stock). One of: `v`, `y`, `n`, `u`, `p`, `g`.

lot_number

string

Optional

Lot number; eCW creates a new lot if none matches. Example: AB1234.

manufacturer_id

string

Optional

FHIR logical ID of the vaccine manufacturer Organization (needed for a new lot) (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

note

string

Optional

Comment to add to the immunization. Example: Patient tolerated well.

performer_id

string

Optional

FHIR logical ID of the practitioner who gave the vaccine (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

route

string

Optional

site

string

Optional

status_reason

string

Optional

Why it was not given (status not-done only): PATOBJ (patient decision), IMMUNE (evidence of immunity), MEDPREC (contraindication) or OSTOCK (vaccine unavailable). One of: `PATOBJ`, `IMMUNE`, `MEDPREC`, `OSTOCK`.

vaccine_name

string

Optional

Vaccine name. Example: COVID-19 (mRNA).

vis_presentation_date

string

Optional

Date printed on the Vaccine Information Statement, as YYYY-MM-DD. Example: 2026-01-15.

vis_publication_date

string

Optional

Date the Vaccine Information Statement was given, as YYYY-MM-DD. Example: 2026-01-15.

eclinicalworks_location_read

Read location

eclinicalworks_medication_administration_search

Search medication administration

eclinicalworks_medication_dispense_read

Read medication dispense

eclinicalworks_next_page

eclinicalworks_observation_read

Read observation

eclinicalworks_observation_search

Search observation

eclinicalworks_observation_vitals_create

Create observation vitals

Record one vital sign for a patient in eClinicalWorks, such as heart rate, temperature, weight, BMI, oxygen saturation or blood pressure. The entry lands in the chart's App Data tab, where a clinician reconciles it into the chart. Returns a transaction-response Bundle whose entry[0].response.location holds the new resource's FHIR ID (check entry[0].response.status for eCW error codes). If effective_date_time matches an encounter's appointment time, eCW shows the value on that visit's Vitals screen; otherwise it goes to Vitals Notes.

Parameters

Name

Type

Required

Description

effective_date_time

string

Required

Date and time the vital was taken, as an ISO 8601 date-time with offset. Example: 2026-01-15T10:00:00-05:00.

loinc_code

string

Required

LOINC code of the vital sign: 9279-1 respiratory rate, 8867-4 heart rate, 8310-5 body temperature, 8302-2 body height, 9843-4 head circumference, 29463-7 body weight, 39156-5 BMI, 59576-9 BMI percentile, 8289-1 head circumference percentile, 77606-2 weight-for-length percentile, 85354-9 blood pressure panel, 2708-6 / 59408-5 oxygen saturation. One of: `9279-1`, `8867-4`, `8310-5`, `8302-2`, `9843-4`, `29463-7`, `39156-5`, `59576-9`, `8289-1`, `77606-2`, `85354-9`, `2708-6`, `59408-5`.

patient_id

string

Required

FHIR logical ID of the patient (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

diastolic

number

Optional

Diastolic pressure in mm[Hg] (blood pressure panel 85354-9 only). Example: 80.

display

string

Optional

Name of the vital sign. Example: Heart rate.

inhaled_oxygen_concentration

number

Optional

Inhaled oxygen concentration in % (oxygen saturation codes only). Example: 21.

inhaled_oxygen_flow_rate

number

Optional

Inhaled oxygen flow rate in L/min (oxygen saturation codes only). Example: 2.

practitioner_id

string

Optional

FHIR logical ID of the practitioner who took the vital (the `id` returned by eCW, an opaque string; not an MRN or account number). Example: 12345.

qualifier

string

Optional

Free-text qualifier shown with the vital, for example the blood pressure position. Example: Sitting.

systolic

number

Optional

Systolic pressure in mm[Hg] (blood pressure panel 85354-9 only). Example: 120.

ucum_code

string

Optional

UCUM code of the unit, from the FHIR ucum-vitals-common value set. Example: /min, Cel, [degF], kg, [lb_av], cm, [in_i], %, kg/m2.

unit

string

Optional

Unit shown with the value. Example: /min, Cel, [lb_av], kg, cm, %, kg/m2.

value

number

Optional

Measured value. Required for every vital except the blood pressure panel (85354-9), which uses systolic and diastolic instead. Example: 72.

eclinicalworks_patient_search

Search patient

eclinicalworks_practitioner_read

Read practitioner

eclinicalworks_procedure_read

Read procedure

eclinicalworks_procedure_search

Search procedure

eclinicalworks_related_person_read

Read related person

eclinicalworks_service_request_create

Create service request

For more tools, view docs.

Build your Agent

Same auth pattern across LangChain, OpenAI, Anthropic, and Google ADK.

import { ScalekitClient } from "@scalekit-sdk/node";
import { createReactAgent } from "@langchain/langgraph/prebuilt";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

// eClinicalWorks tools scoped to this user
const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["eclinicalworks"], toolNames: [
    "eclinicalworks_patient_search",
    "eclinicalworks_patient_everything",
    "eclinicalworks_condition_search"] },
  pageSize: 100,
});

const agent = createReactAgent({ llm, tools });
await agent.invoke({ messages: [{ role: "user", content: "Find Maria Lopez and list her active problems before tomorrow's visit" }] });

import OpenAI from "openai";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const openai = new OpenAI();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["eclinicalworks"] }, pageSize: 100,
});

const res = await openai.chat.completions.create({
  model: "gpt-5",
  messages: [{ role: "user", content: "Find Maria Lopez and list her active problems before tomorrow's visit" }],
  tools,
});

// Execute the tool call with the user's vaulted eClinicalWorks OAuth token
await sk.tools.executeTool(res.choices[0].message.tool_calls[0], "user_123");

import Anthropic from "@anthropic-ai/sdk";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);
const anthropic = new Anthropic();

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["eclinicalworks"] }, pageSize: 100,
});

const msg = await anthropic.messages.create({
  model: "claude-sonnet-5",
  max_tokens: 1024,
  messages: [{ role: "user", content: "Find Maria Lopez and list her active problems before tomorrow's visit" }],
  tools,
});

// Tool call runs with the user's vaulted eClinicalWorks OAuth token
await sk.tools.executeTool(msg.content, "user_123");

import { Agent } from "@google/adk/agents";
import { ScalekitClient } from "@scalekit-sdk/node";

const sk = new ScalekitClient(env.SCALEKIT_ENV_URL, env.SCALEKIT_CLIENT_ID, env.SCALEKIT_CLIENT_SECRET);

const { tools } = await sk.tools.listScopedTools("user_123", {
  filter: { connectionNames: ["eclinicalworks"] }, pageSize: 100,
});

const agent = new Agent({
  name: "clinical_agent",
  model: "gemini-2.5-pro",
  instruction: "eClinicalWorks tools scoped to this user",
  tools,
});

await agent.run("Find Maria Lopez and list her active problems before tomorrow's visit");

Try these prompts

Copy any prompt into your agent. Each maps directly to a eClinicalWorks tool. Click to copy, paste into your agent, done.

Patient records

Copy the prompt

Copied

Search for patients named Maria Lopez born in 1984.

Copy the prompt

Copied

Pull everything on file for this patient in one bundle.

Copy the prompt

Copied

List this patient's lab observations from the last 6 months.

Charting

Copy the prompt

Copied

Write a progress note into this patient's encounter from today.

Copy the prompt

Copied

Create a telephone encounter for this patient's callback about refills.

Copy the prompt

Copied

Record a blood pressure reading of 128/82 for this patient.

Orders and coverage

Copy the prompt

Copied

Place a lab order for a lipid panel for this patient.

Copy the prompt

Copied

Create an outgoing referral for this patient to cardiology.

Copy the prompt

Copied

Add this insurance policy to the patient's demographics.

SEE HOW AUTH WORKS

Each user signs in to eClinicalWorks once, and Scalekit stores and refreshes their tokens. Credentials stay vaulted, every call is scope checked, and every action is logged.

Authorize

Your user connects

eClinicalWorks

once. We tie it to their identity and the meetings they approved — no shared bot account, no org-wide access

Who:

user ‘A’

when:

Once per user

access:

Limited to user

Store

Their

eClinicalWorks

token lives in a vault scoped to them. User A's meetings are never reachable by an agent acting for user B, even on the same connection

vault:

encrypted

scope:

per-user

tokens:

auto-refreshed

Resolve

When your agent calls a

eClinicalWorks

tool, we fetch the right token server-side. It never touches your agent, never appears in the LLM context, never shows up in your logs

speed:

~40ms

check:

before every call

seen by:

nobody

Audit

Every

eClinicalWorks

tool call is logged — who triggered it, which meeting was fetched, what came back. 90 days of history, tied to the user who authorized it

history:

90 days

export:

SIEM-ready

logged:

every call

Test other agents

See the same per-user auth pattern across other healthcare connectors.

Support and Ops Teams

Meeting prep

Pulls agenda, participant context, and open action items before every meeting.

Engineering Teams

Slack triage

Polls Slack for new messages, classifies bugs and support requests with a LangGraph router, files GitHub issues or Zendesk tickets, and confirms in the thread.

Why Scalekit

Secure your agent's access. Connectors ship in minutes

01.

Shared tokens break per-user analytics

A shared eClinicalWorks token looks fine in a demo. In production every chart entry looks like one service account, and you cannot tell which user triggered it. Scalekit resolves the credential of the actual user who triggered the agent, never a shared bot.

// shared token
audit → bot_service_account

// scalekit
audit → user_abc ✓

02.

Authentication is not authorization

03.

Multi-tenancy is architectural

04.

eClinicalWorks today. Ten connectors tomorrow.

“Our agents act across Salesforce, Gong, Google Drive, and more, on behalf of every customer. Scalekit behind the scenes meant we can keep adding tools without ever rebuilding how credentials or tool calling work.”

Venu Madhav Kattagoni

Head of Engineering / Von

FAQs

Frequently Asked Questions

Does the agent access eClinicalWorks as the user or through a shared service account?

As the user. Each user signs in to eClinicalWorks once with SMART on FHIR, and Scalekit stores and refreshes their tokens. Every chart read and write in your audit trail is attributed to that user, not a shared service account.

Where is the eClinicalWorks OAuth token stored?

In Scalekit's managed AES-256 token vault, namespaced per tenant. Refresh is automatic. Revocation is a single dashboard action. Credentials never appear in prompts, logs, or LLM context.

Can I limit what the agent does in eClinicalWorks?

Yes. Filter by tool name in listScopedTools to expose only what you want, for example the read and search tools without eclinicalworks_coverage_delete or eclinicalworks_organization_patient_pharmacy_delete, which remove an insurance policy or a pharmacy from a patient's record. Scalekit also enforces scope checks before every API call.

What happens when a user revokes eClinicalWorks access?

The connection is invalidated on the next tool call. Subsequent requests for that user fail closed with a clear error. Other users in the tenant remain unaffected. The event is logged for audit.

Can the agent pull a patient's full record from eClinicalWorks in one call?

Yes. eclinicalworks_patient_everything runs the FHIR $everything operation on a patient and returns a Bundle of their record. For a narrower view, the search tools filter by resource type, and eclinicalworks_next_page follows the next link in long results.