Fold API and Webhooks
Build on the same API our AI agents use.
Read work items, prepare changes and receive signed webhooks. People keep approvals. Access is on request.
- statein_progress
- ownerJordan Reyes, RN
- programTCM · visit by Mon 11/2
- approvalGranted · Daniel Wright, PharmD
- Daniel Wright, PharmD approved
- Fold sent approval.granted
- riverside-warehouse reading TOC-20417
Fold runs the work between your feeds and EHR.
Feeds come in, AI agents prepare, people approve and updates go back. Your EHR stays the record.
01You send
- ADT feedHL7 v2 A01 A03 A08
- Enrollment and claimsX12 834 and 837
- Chart accessFHIR R4
02Fold runs
- PrepareAgents draft within scopes
- ApproveA named person decides
- CloseDone only when evidence exists
03You receive
- Your warehouseSigned events
- Your appsWork items and approvals
- Your EHRFHIR updates where supported
Every step is an event.
Your endpoint gets a signed event for every step, with actor and time.
- adt.seq 1
discharge. St. Mary’s ADT · Mon 4:02 PMreceived - agent.seq 2
action. Medication AI agent · Mon 4:14 PMprepared - DWapproval.seq 4
granted Daniel Wright, PharmD · Mon 5:20 PM 
contact.seq 5logged Jordan Reyes, RN · Tue 9:20 AM
A work item is done only when evidence exists.
member work_item agent_action approval evidence eventYour care team works in these same records.
- Read discharge med list
- Compared with pharmacy fills
- Lisinopril filled · 36 h washoutPharmacist
Your services can read and prepare, never approve.
OAuth client credentials grant scoped reads and drafts. Only signed in people approve.
- work_items:readAllowed
- documents:readAllowed
- work_items:writeApproval
- approvals:writePeople only
- ReadQueuedwork_items · TOC-20417
- PrepareQueuedwork_items · draft, needs approval
- ApproveQueuedapprovals · medication review
Signed, retried, safe to replay.
Deliveries can repeat. Verify each one and process it once.
Signed
Verify the signature against the raw body.
Retried
Expect retries with the same event id.
Processed once
Record handled ids and acknowledge repeats.
- 1SendingSending5:20:12 PM
- 2PendingWaits for a retrySame event id
- 3PendingWaits for a retrySame event id
Deployment options
Choose by where your people work.
We meet you where you are in your technology strategy. Connections to 20+ EHRs, AI agents, approvers and the audit trail stay the same.
| Fold appsWeb, iOS and Android, under your brand | Inside your EHREmbedded | Your own productHeadless APIs | |
|---|---|---|---|
| Who works there | Care managers and coordinators | Physicians at the point of care | Your product and engineering teams |
| What you set up | Configure with Fold | An EHR launch with your IT team | Your own interface on these APIs |
| Brand | Your name and domain | Your EHR’s screens with a Fold panel | Entirely yours |
| Same in every option | Data connections | AI agents and named approvers | One audit trail |
Fold apps
Web, iOS and Android, under your brand
- Who works there
- Care managers and coordinators
- What you set up
- Configure with Fold
- Brand
- Your name and domain
Inside your EHR
Embedded
- Who works there
- Physicians at the point of care
- What you set up
- An EHR launch with your IT team
- Brand
- Your EHR’s screens with a Fold panel
Your own product
Headless APIs
- Who works there
- Your product and engineering teams
- What you set up
- Your own interface on these APIs
- Brand
- Entirely yours
Same in every option
- Data connections
- AI agents and named approvers
- One audit trail
Your owners approve four gates. We set dates after reviewing your feeds.
Connect
Your data steward signs off matched records.
Validate
Your clinical owner signs the workflow map.
Supervised go live
Routing, approvals and evidence meet your criteria.
Measure and expand
Your sponsor decides expansion on agreed thresholds.
Questions about building on Fold.
Is the API public?
Not yet. Access is set up per deployment. Documentation is shared on request.
Can our own AI agents call Fold?
Yes, as a scoped client. They read and prepare work. Signed in people approve.
What PHI is in a webhook?
Workflow status tied to a member, so treat every delivery as PHI. Documents are separate scoped reads, each logged.
Can we mix the deployment options?
Yes. Care managers on the console, physicians in the EHR, product teams on APIs. We scope only what you add.
Does Fold replace our EHR?
No. Your EHR stays the system of record. Fold writes back only where confirmed for your deployment.
What do we confirm before building?
Test access, authentication, tenant boundaries, rate limits, retries and EHR write permissions. We review hosting and data flows with your security team.
Plan your
Fold integration.
Before you write code, our engineers and clinical leads map your feeds, scopes and write boundaries with you.
Talk to our engineers