EHR Integration Due Diligence: The Questions That Decide the Timeline
ByClunic Research Team11 min read
Free tool
Twelve factual questions on data access, governance and change capacity.
Need it signed off?
Thirty free minutes with an analyst on the vendor, the workflow and the rule you are unsure about.
Book an evaluation callWhy does integration decide the project?
Because integration is where the schedule actually lives. Product selection takes weeks. Integration takes quarters, and it is the part nobody costs properly.
The pattern repeats across deployments. A practice picks a tool in a month, signs in six weeks, and then spends two quarters waiting for a connection that was described in the sales process as available. The word doing the damage is usually available, which can mean listed in the app store and installable this afternoon, or can mean we have built to that API and no customer has yet turned it on with your version.
The questions below are designed to make that distinction impossible to blur. They are also worth asking before the shortlist rather than after, because integration depth is one of the few criteria that legitimately removes vendors from consideration. Our per-system pages, starting with Epic and Oracle Health, cover what each vendor's programme actually requires, and the full set is indexed at the EHR integration hub.
FHIR or a proprietary API, and does it matter?
It matters, though not in the way the marketing implies. FHIR is a standard, not a guarantee of access, and every major EHR vendor also exposes proprietary interfaces that do things FHIR does not.
| Method | What it is good for | Limits | What to ask |
|---|---|---|---|
| Standard FHIR read | Patient demographics, problems, medications, allergies, results. Broadly supported | Read-heavy. Write support is narrower and varies by system and version | Which FHIR resources, which version, and read or write? |
| Proprietary or vendor-specific API | Writing notes, orders and documents into the chart where FHIR cannot | Ties you to that EHR. Usually gated behind a partner programme | Is this available to us or only to the EHR vendor's own partners? |
| HL7 v2 interface | Established messaging, especially results and ADT | Interface engine work, per-site configuration, not real time in the modern sense | Who builds and maintains the interface, and at whose cost? |
| Browser extension or screen automation | Fast to deploy, works where no API exists | Brittle. Breaks on EHR upgrades. Often outside the vendor's supported configuration | What happens when the EHR changes, and is this permitted under our EHR agreement? |
| Copy and paste | Honest, immediate, no dependency | Clinician effort per note, no structured data | Is this what we are actually buying, described as an integration? |
The distinction that matters most is read versus write. Reading context out of the chart is comparatively easy and widely supported. Writing a note, an order or a document back into the chart is where value concentrates and where access is gated. Ask for the read list and the write list separately, because a vendor that says it integrates with your EHR is frequently describing read-only access.
ASTP/ONC certification criteria require certified health IT to expose standardised API functionality, which is why FHIR read access has become broadly reliable. Note that the certification landscape is itself in motion: a deregulatory proposal published in December 2025 would eliminate a large share of existing certification criteria, and it had not been finalised as of August 2026. The current position is tracked in the regulation tracker.
What does app store listing actually tell you?
That the vendor completed a programme, which is genuinely useful, and not that your instance can install it tomorrow.
Each major EHR vendor runs a partner or marketplace programme with its own review, technical validation and commercial terms. A listing means the integration has been built and reviewed against that programme. It does not tell you whether your version supports it, whether your organisation has the relevant module licensed, or whether your EHR vendor's team has capacity to enable it this quarter.
Three questions get you past the badge. Is the vendor listed today, or applying? Ask for the listing URL. How many customers are live on this integration with our EHR, and may we speak to one? And what is the shortest and longest time to production among those customers? The gap between shortest and longest is the honest estimate of your own timeline.
Timelines vary widely by EHR vendor and by what you are asking for. Read-only connections through a standard programme are routinely faster than write-back into the chart, and write-back into a hospital instance is slower than the same integration into an ambulatory one. Rather than trust a generic figure, ask the vendor for the range across its own live customers, and ask your EHR account team the same question independently. Where the two answers differ materially, believe the EHR vendor. Per-system detail sits on athenahealth, eClinicalWorks and NextGen.
What should you ask about sandbox and production access?
Four questions that separate a built integration from a demonstrated one.
- Do you have sandbox credentials for our EHR today, and how long did it take to get them?
- Have you tested against our EHR version, and can you name it?
- What has to happen on our side, and who at our EHR vendor has to be involved?
- Who owns the connection when it breaks after an EHR upgrade?
Question two catches more problems than the others combined. EHR versions differ in what APIs they expose, and a vendor that has integrated with the current release may not have tested against the version you are running. Ask for your version number to be named back to you.
Question three is the one that produces the schedule. Almost every meaningful integration requires work from your EHR vendor: enabling an app, provisioning credentials, configuring a client. That work sits in someone else's queue, and it is the dependency that turns a six week project into a six month one. Find out early who is in that queue and what it takes to get on it.
Question four is a contract question disguised as a technical one. EHR vendors upgrade on their own schedule and integrations break. The useful answer names an owner and a response time. The unhelpful answer is that upgrades rarely cause issues, which is a prediction rather than a commitment.
Who actually pays for the integration?
One of three parties, and you should know which before signature rather than after.
The AI vendor may absorb it, which is common where the integration is a standard app store listing already built. You may pay a one-off implementation or integration fee to the AI vendor, which is normal at the enterprise end and should appear in the order form rather than arrive later. Or you may pay your EHR vendor, through interface fees, module licences or professional services, and this is the cost most often missed because it lands on a different budget line and sometimes in a different department.
Ask three direct questions. What is the total one-off cost of getting to production, from all parties. Which of those costs are quoted and which are estimated. And does anything recur annually, such as an interface maintenance fee or a per-connection charge from the EHR vendor.
Then ask your EHR account team the same question independently, without the AI vendor in the room. The two answers are frequently different, not through dishonesty but because each party knows its own side of the fee schedule. The difference between the two is the number that should go into your business case, and it belongs in the model before you run the ROI calculation rather than after.
What if your EHR is not one of the big two?
Then the questions are the same and the answers are thinner, which is useful information rather than a problem.
AI vendors build integrations where the customers are, so the depth available on Epic and Oracle Health is generally ahead of what is available on MEDITECH, Veradigm or a smaller specialty system. That does not mean nothing works. It means the honest answer for your system is more often a standard FHIR read plus copy and paste, or an extension, than a native write-back, and you should price the product on that reality rather than on the roadmap.
Two things to do differently. Ask the AI vendor how many customers it has live on your specific system, and if the answer is zero, negotiate as a first customer: a discount, a shorter term, and a written date. And ask your own EHR vendor what its partner programme requires, because in some systems the constraint is programme capacity rather than technology, and your account team can sometimes move it.
The third option, which is underrated, is to choose a workflow that does not need deep integration. Ambient documentation with copy and paste is genuinely workable at small scale. A phone agent that reads the schedule and writes nothing back can deliver most of its value through a lighter connection. Picking the workflow to fit the integration reality is usually cheaper than forcing the integration to fit the workflow.
What are the integration red flags?
Five, in rough order of how expensive they turn out to be.
- Integration described without a method. If the vendor cannot say FHIR, proprietary API, HL7 or extension, there is no integration yet. There may be a plan.
- No named live customer on your EHR. Being the first customer on a connection is a legitimate choice, at a discount, with a longer timeline written into the contract. It is not a legitimate surprise.
- Write-back promised on the roadmap. Roadmap write-back is a future you are paying for now. Price it as read-only until it ships, and put a date and a remedy in the contract.
- Screen automation presented as integration. Sometimes the right pragmatic answer, particularly where no API exists. But it must be disclosed, it must be checked against your EHR agreement, and it must be priced as the maintenance liability it is.
- Silence on upgrade breakage. No named owner and no response time for a post-upgrade failure means the clinic that breaks on a Monday morning is your problem.
None of these should automatically disqualify a vendor. All of them should change what you sign: a shorter term, a milestone-linked payment, or a written commitment with a date attached. The other half of the diligence, on data handling and the business associate agreement, is in the fifteen vendor questions.
How should integration sit in the buying sequence?
Second, immediately after the compliance screen and before the demo. That ordering saves the most time, because both screens remove vendors on paper.
A workable sequence: screen on compliance posture, screen on integration method and evidence, demo the two survivors, pilot one, and only then negotiate. Most organisations reverse the middle two, demo four vendors and discover integration constraints in week nine, by which point a clinical champion has a preference and the constraint becomes a negotiation rather than a fact.
Write the integration answers into the contract, not the notes. A named method, a named EHR version, a date for production, and a remedy if it slips. Vendors who have done this before will accept that language because they know their own timeline. Vendors who have not will resist it, which is itself the answer to the question you were asking.
Two final links worth having open while you do this. The HIPAA-compliant AI tools shortlist records what each vendor publicly documents, including integration claims, and the ambient documentation page describes where write-back actually changes the workflow rather than just the demo. If you would rather have someone run the diligence with you, the vendor selection engagement produces the scored comparison and the integration feasibility note for your specific estate, and the deployment roadmap is what turns it into a sequence with dates.
Sources
Primary material behind the claims above. Read the source before acting on any summary of it.
- ONCCertification of health IT, ASTP/ONC (opens in a new tab)
- OtherHL7 FHIR specification (opens in a new tab)
- ONCUnited States Core Data for Interoperability (USCDI), ASTP/ONC (opens in a new tab)
- ONCHealth Data, Technology, and Interoperability: ASTP/ONC Deregulatory Actions To Unleash Prosperity (HTI-5 proposed rule) (opens in a new tab)
- ONCInformation blocking, ASTP/ONC (opens in a new tab)
- CMSAPIs and relevant standards and implementation guides, CMS (opens in a new tab)
Questions we get asked
Does FHIR mean an AI vendor can write into my EHR?
Not on its own. FHIR read access is broadly supported across certified health IT. Write access is narrower, varies by system, version and resource, and writing clinical notes or orders often requires a proprietary interface behind the EHR vendor's partner programme. Ask for the read list and the write list separately.
How long does EHR integration take for an AI agent?
It varies too widely for a single number to be useful. Read-only connections through an existing app store listing are the fastest, write-back into a hospital instance the slowest, and your EHR vendor's queue is usually the binding constraint. Ask the AI vendor for the shortest and longest time to production among its live customers on your EHR.
What does an EHR app store listing prove?
That the vendor completed that EHR's partner programme and its integration was reviewed. It does not prove your version supports it, that you have the relevant module licensed, or that your EHR vendor has capacity to enable it this quarter. Ask for the listing URL and a reference customer on your system.
Who pays the EHR integration fee?
It can be the AI vendor, you, or your EHR vendor through interface fees, module licences or professional services. Ask all parties separately for the total one-off cost to production and anything that recurs annually. The EHR vendor cost is the one most often missed because it lands on a different budget line.
Is a browser extension a real integration?
It is a real deployment method and sometimes the right pragmatic choice where no API exists. It is brittle, it breaks on EHR upgrades, and it may sit outside your EHR agreement's supported configuration. Treat it as a maintenance liability with a named owner and a response time, and price it accordingly.
Should integration questions come before or after the demo?
Before. Integration method and evidence can be screened on paper, and doing so removes vendors before anyone in the room has developed a preference. Reversing the order is how organisations discover a constraint in week nine and then negotiate around it instead of acting on it.
Know what changed before your vendor tells you
A monthly regulatory and vendor intelligence note for people who have to sign off on this. What moved in HIPAA, ONC and state AI rules, and which vendor claims stopped being true.
Book an evaluation call at any point. No obligation.