Overview
Hint powers thousands of Direct Primary Care practices with software built to streamline operations and enable better patient care. This API enables you to build partner apps & integrations, and gives you programmatic access to the day to day workflows of these clinics - including patient enrollment, membership billing, practice configuration, clinical data management, and more.
Choose your path
| Audience | Description | Start here |
|---|---|---|
| Marketplace partners | Build integrations that can be activated by many practices through the Hint Marketplace | Marketplace Overview |
| Practice developers | Automate workflows for a single practice (practice staff, consultants, in-house devs) | Making Requests |
Practice API AccessTo request Practice API Access, contact [email protected]. This requires approval from a practice admin.
Platform fundamentals
- Every request uses HTTPS with Bearer tokens. Review Making Requests for headers, pagination, and rate limits.
- Most work happens via
/api/provider/*endpoints using a practice-specific access token. Partner-level setup (marketplace listing, connections, webhooks) uses your Partner API key. - Hint provides both Production and Sandbox environments with separate credentials.
- Webhooks are the primary push channel. Configure them once per partner to capture lifecycle events across every connected practice (Webhooks).
Resource namespaces
| Scope | Endpoints | Typical actions | Auth |
|---|---|---|---|
| Practice data | /api/provider/* | Work with patients, memberships, invoices, practitioners, practice configuration | Practice-specific access token |
| Partner setup | /api/partner/* | Manage your marketplace listing, connections, webhooks, and integration metadata | Partner API key |
The/api/partner/*namespacePartner-facing operations live under
/api/partner/*: your marketplace listing (products, surfaces, testimonials), backends, webhook endpoints, webhook events, and per-practice connections (installations). All authenticate with your Partner API key.
Practice resources (Provider endpoints)
Practice resources expose PHI and practice-level configuration via /api/provider/*. You must keep one access token per practice and rotate them per your compliance program. Use these endpoints to:
- create or update patients, memberships, and invoices
- sync practice configuration data such as pricing, consent, or staff rosters
- trigger operational workflows (e.g., charge creation, refunds)
Partner resources
Partner resources define how Hint recognizes and reaches your integration across every practice. Use your Partner API key to:
- exchange authorization codes for practice access tokens (activate a connection)
- manage your marketplace listing (products, app surfaces, testimonials, and supporting content)
- register and verify webhook delivery targets, and browse the webhook events you can subscribe to
- review each practice connection (installation) and its lifecycle
Under /api/partner/* these group into a small resource model:
- Backends hold your partner configuration and own your partner-level webhook endpoints.
- Products are the listings practices install. Each product carries its app surfaces (embedded entry points), testimonials, and supporting content (highlights, links, overview, preconditions, categories).
- Installations represent a single practice's connection to one of your products. Per-connection credentials (API keys) and webhook endpoints are reached through the installation.
See Partner Endpoints and Managing Your Listing for the full reference.