Introducing the Avon Health SDK

From day one, Avon has been API-first. The same REST API that powers our own product is the one we hand to every customer — predictable, resource-oriented URLs, JSON in and JSON out, standard verbs and status codes. No special access tier, no surprise bill for hitting our API — every call is included, on the house. Just the full `/v2` surface: patients, scheduling, notes, forms, billing, the patient chart, and more.

And developers have run with it. Teams have built custom intake flows, synced charts into their own apps, automated billing, wired up messaging, and stood up entire patient experiences on top of Avon. The feedback has been some of the most rewarding we've gotten — that the APIs are super easy to use, that the documentation is so good teams have modeled their own APIs around it, and that they were up and running in minutes. To date, over a million API calls have been made against it.

The REST API is great, it's loved, and it isn't going anywhere. We're just making it even easier to build on.

Meet the official Avon Health SDK — `@avon-health/sdk`. Same API underneath, now with autocomplete, types, and a lot less boilerplate.

What it is

A fully typed TypeScript/JavaScript library that wraps the `/v2` REST API with typed resource services, automatic auth, pagination helpers, retries for transient failures, and typed errors. Everything you could already do with raw HTTP, now with autocomplete and a lot less boilerplate.

It's an ESM package, requires Node.js 18+, and ships with TypeScript declarations bundled — no separate `@types` install.

npm install @avon-health/sdk

What it helps you build

The Avon Health SDK helps developers interact with Avon more efficiently across core healthcare workflows, including:

• Patients
• Appointments
• Forms
• Notes
• Tasks
• Messages
• Documents
• Billing workflows
• Eligibility checks
• Insurance claims

Instead of manually handling every request, response, authentication flow, and error state, developers can use the SDK to get started faster and build with more confidence.

Quick start

import { Avon } from "@avon-health/sdk";

const avon = new Avon({
  baseUrl: "https://{{base_subdomain}}.avonhealth.com",
  account: "acct_123",
  clientId: "<client_id>",
  clientSecret: "<client_secret>",
  jwt: "<jwt>",
});

const patient = await avon.patients.create({
  first_name: "Ada",
  last_name: "Lovelace",
  email: "ada@example.com",
});

const fetched = await avon.patients.retrieve(patient.id);
await avon.patients.update(patient.id, { phone: "(555) 555-0123" });

const patients = await avon.patients.list({ limit: 50 });
await avon.patients.del(patient.id);

That's the whole loop — create, retrieve, update, list, and delete — fully typed, with the right headers attached for you on every request.

Get started

If you're already building on Avon, the SDK is a drop-in upgrade — same API, same endpoints, far less plumbing.

npm install @avon-health/sdk

Full reference, authentication details, and the complete resource list live in the docs at docs.avonhealth.com. If you're not building on Avon yet and want access to the API or our no-code/low-code platform, reach out at hello@avonhealth.com.

A million calls in and we're just getting warmed up. We can't wait to see what you build.