Healthie API integration guide: GraphQL, webhooks and Healthie Harbor
- Access model
- Partner program + customer API key
- Developer program
- Healthie Harbor
- Certified FHIR access
- FHIR R4 add-on (Enterprise plans)
- Scheduling write
- Yes, via GraphQL
The short answer
Healthie is API-first. Its GraphQL API covers appointments, clients, charting and billing, with signed webhooks for events. Third parties build through the Healthie Harbor partner program, and each customer typically requests its own API key to switch your integration on. A certified FHIR R4 API exists as an add-on for Enterprise customers.
How access works
- Apply to Healthie Harbor: who you are, mutual customers, what you integrate, prior EHR integrations, and HIPAA and SOC 2 status. Healthie prioritizes partners with existing customer overlap.
- Pass a security review and sign the partnership agreement. Fees are defined in the agreement, not published.
- Get documentation and sandbox credentials, build, then pass a technical review.
- Customers activate you by requesting an API key from Healthie for your integration.
What the APIs cover
| Job | Path on Healthie |
|---|---|
| Book, update, cancel appointments | GraphQL appointment mutations |
| Clients, forms, charting, billing | GraphQL |
| Events | Webhooks (HMAC-signed, retries up to 3 days, IP allowlist) |
| Certified FHIR read | FHIR R4 add-on, Enterprise only, typical setup 4–6 weeks |
| Data export | ONC EHI export |
Your first Healthie integration, step by step
- Get a staging key. Generate one as described in Healthie's Authentication guide, or ask Healthie to provision it. Build against
https://staging-api.gethealthie.com/graphql; production ishttps://api.gethealthie.com/graphql. - Send the right headers. Every request is a JSON
POSTwithAuthorization: Basic <API key>andAuthorizationSource: API. Sharded organizations also need anAuthorizationShardheader. - Pin an API version. Healthie ships dated versions (2024-06-01 through 2026-10-01 at the time of writing) and keeps a changelog. Pin one and upgrade on purpose.
- Book an appointment.
createAppointmentneedsdatetime,appointment_type_idandcontact_type(list valid values with thecontactTypesquery), plususer_idfor 1:1 visits. - Wire webhooks. Subscribe to
appointment.createdandappointment.updated. Verify the HMAC-SHA256Signatureagainst theSignature-InputandContent-Digestheaders. Created and deleted payloads carry only the resource ID, so fetch the details over GraphQL.
Pitfalls we plan around
createAppointmentignores availability unless you passenforce_availability: true. Without it, double bookings go through. Patient-sidecompleteCheckoutdoes enforce availability.- Retries are opt-in. With retries on, failed deliveries back off for up to 3 days, then the webhook is disabled. Alert on failures before that point.
- Sub-organizations: a parent org's webhook receives events from every sub-org, so filter by organization.
Our take
GraphQL plus webhooks makes Healthie quick to build on once you're in. The gate is commercial: Harbor favors partners whose customers already ask for them. If you're early, lead with a design-partner customer on Healthie.
FAQ
Does Healthie have an API?
Yes, a versioned GraphQL API with queries, mutations, subscriptions and webhooks.
How do I become a Healthie integration partner?
Apply to Healthie Harbor, pass a security and technical review, and sign the partnership agreement. Customers then request an API key to enable your integration.
Does Healthie support FHIR?
Yes, as a certified FHIR R4 add-on for Enterprise customers, with a typical setup of 4–6 weeks.
Sources
Public pages, accessed 11 Oct and 13 Nov 2026: Healthie API docs · Become a partner · Healthie Harbor · Webhooks guide · Activating a marketplace partner · FHIR API add-on · Quick start (endpoints, headers) · Appointments guide
Other EMR integration guides
eClinicalWorks
Self-registration + per-customer approvalEpic
Marketplace partner + practice authorizationathenahealth
Self-service FHIR + partner-gated proprietary APIModMed
Registration + per-customer tenant provisioningOracle Health (Cerner)
Tiered programs; distributor terms for vendorsNextGen Healthcare
The audit is free. Another quarter of guessing is not.
Book the Free 48-Hour Audit