Adapters
Adapters are prebuilt Linkiir nodes that connect a workflow to an external system. Each one arrives as a node template plus the code library behind it, so you add it from the palette and fill in fields rather than writing a client from scratch.
You configure credentials, endpoints, and what to fetch or send. The connection work — authentication, token refresh, request signing, retries, error reporting — is already done.
Getting the adapters
Adapters are published as catalogs — public git repositories your grid subscribes to. Subscribing adds a catalog's adapters to the node palette and keeps them updatable in place afterwards, with no product upgrade and no support request.
Adapter Catalogs lists every catalog with the public GitHub URL to paste into Settings → Catalogs. All the repositories are public and cloned anonymously, so no SSH key is needed.
| Catalog | Covers | Repository |
|---|---|---|
| FHIR Adapters | Epic, Cerner, eCW, ModMed, Athena, FHIR tools | https://github.com/Linkiir/linkiir-fhir-adapters |
| EHR Adapters | PointClickCare and other non-FHIR EHR APIs | https://github.com/Linkiir/linkiir-ehr-adapters |
| Diagnostics Adapters | Dexcom CGM, labs, imaging, devices | https://github.com/Linkiir/linkiir-diagnostics-adapters |
| Business Adapters | Salesforce, Dynamics 365, ERP, identity | https://github.com/Linkiir/linkiir-business-adapters |
| Transport Adapters | AWS S3, object storage, brokers | https://github.com/Linkiir/linkiir-transport-adapters |
| Notification Adapters | Slack, chat, SMS, email, paging | https://github.com/Linkiir/linkiir-notification-adapters |
| AI Adapters | Azure OpenAI and other model services | https://github.com/Linkiir/linkiir-ai-adapters |
| Developer Tools | Data Simulator for HL7 v2, C-CDA, FHIR and X12 test data | https://github.com/Linkiir/linkiir-devtools |
If your grid has no outbound route to GitHub, a catalog can be delivered on a mounted share or removable drive instead — see Offline Delivery. Adapters can also arrive as a project to import, with templates and libraries already attached to the nodes that use them; see Project Import and Export.
Available adapters
By catalog
Which catalog publishes each adapter, and the library it uses. Subscribe to the catalog to get the adapter.
| Adapter | Catalog | Connects to | Library |
|---|---|---|---|
| HAPI FHIR / OmniVera | FHIR Adapters | HAPI FHIR or Smile OmniVera endpoint | hapi_fhir |
| Epic | FHIR Adapters | Epic FHIR endpoint | epic_fhir |
| Cerner | FHIR Adapters | Cerner FHIR endpoint | cerner_fhir |
| eClinicalWorks | FHIR Adapters | eCW FHIR endpoint | ecw_fhir |
| ModMed | FHIR Adapters | ModMed FHIR endpoint | modmed_fhir |
| Athena Health | FHIR Adapters | Athena Health platform | athena_health |
| HAPI FHIR / OmniVera | FHIR Adapters | HAPI FHIR or Smile OmniVera endpoint | hapi_fhir |
| FHIR Resource Creator | FHIR Adapters | Nothing — local transformation | fhir_creator |
| FHIR Validator | FHIR Adapters | A FHIR server's $validate operation | fhir_validate |
| FHIR Profiling Tools | FHIR Adapters | Nothing — local HTTP service | fhir_profiling |
| PointClickCare | EHR Adapters | PointClickCare organization | pcc_api |
| Dexcom CGM | Diagnostics Adapters | Dexcom CGM account | dexcom_cgm |
| Salesforce | Business Adapters | Salesforce REST API | salesforce |
| Dynamics 365 | Business Adapters | Microsoft Dynamics 365 CRM | dynamics_crm |
| AWS S3 | Transport Adapters | S3 and S3-compatible storage | aws_s3 |
| Slack | Notification Adapters | Slack workspace | slack |
| Azure OpenAI | AI Adapters | Azure OpenAI deployment | azure_openai |
Start here
| If you want to | Read |
|---|---|
| Understand how an adapter is delivered and configured | How Adapters Work |
| Pull patient data from an EHR | Epic, Cerner, eClinicalWorks, ModMed, Athena Health |
| Read glucose data from a CGM device | Dexcom CGM |
| Read or write records in long-term care | PointClickCare |
| Read or write records in a CRM | Salesforce, Dynamics 365 |
| Move messages through object storage | AWS S3 |
| Send an alert to a channel | Slack |
| Send message content to a model | Azure OpenAI |
| Build or inspect FHIR resources locally | FHIR Resource Creator, FHIR Profiling Tools |
What every adapter has in common
- Fields, not code. Endpoints, credentials, and what to fetch are node configuration. See How Adapters Work.
- Live Mode. A switch that lets the node authenticate and log what it would send, without sending it. Use it for the first run of every adapter.
- Verify TLS on by default. Certificate verification stays on unless you deliberately turn it off for a local test proxy.
- Secrets stored as masked fields. Passwords, API keys, and secret keys are encrypted in the project and never written to logs. Private keys stay on disk and are referenced by path.
- Errors in the node log. Each adapter reports a stable error code and a readable message, listed on its page.
Point a new adapter at the vendor's sandbox or test environment, with synthetic data, before connecting it to production. See Sample Code for the practices the demo interfaces follow.
Next
- Adapter Catalogs — repository URLs and how to subscribe
- How Adapters Work
- Linkiir Catalogs Release Notes — what changed in each catalog
- Interfaces and Core Nodes
- Project Settings