# Hint Health API Documentation > The Hint API allows partners, providers and employers to deeply integrate with our core technology infrastructure. ## Guides: Getting Started - [Overview](https://developers.hint.com/docs/overview.md): 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… - [Hint MCP Server](https://developers.hint.com/docs/hint-mcp-server.md): Connect AI coding assistants to Hint’s public developer documentation using the Hint MCP server. ## Guides: Hint Marketplace - [Marketplace Overview](https://developers.hint.com/docs/marketplace.md): Build rock-solid integrations and embedded apps that practices can discover and install inside Hint. - [Join the Marketplace](https://developers.hint.com/docs/become-a-partner.md): We pride ourselves on running a predictable launch cadence for Hint Marketplace partners. When we move forward with a partnership, our team stays engaged through go-live to guarantee a smooth rollout… - [Building an Integration](https://developers.hint.com/docs/building-an-integration.md): Implementation steps for Integration Partners in the Hint Marketplace. - [Integration Activation](https://developers.hint.com/docs/integration-activation.md): How practices enable your integration and how partners exchange credentials. - [Downloading Interaction Files](https://developers.hint.com/docs/downloading-interaction-files.md): Request short-lived, single-use download URLs for an interaction's file attachments, and delete one attachment by id. - [Partner Charges](https://developers.hint.com/docs/partner-charges.md): Route fees through Hint so practices get one consolidated invoice -- bill a patient or the practice, itemize with line items, and categorize the charge. - [Building an App](https://developers.hint.com/docs/building-an-app.md): Build an embedded app that runs inside Hint. Start with a minimal workflow, then add deeper surfaces and automation. - [JS SDK](https://developers.hint.com/docs/js-sdk.md): How to embed apps in the Hint UI - [Roles & Access Context](https://developers.hint.com/docs/roles-and-access-context.md): Understand the partner roles Hint assigns to each user, and handle Hint platform-support sessions correctly with access_context. - [App Best Practices](https://developers.hint.com/docs/app-best-practices.md) - [Colors & Typography](https://developers.hint.com/docs/design-system.md): Use this guide to keep Hint Marketplace apps visually consistent with the Hint UI. - [Localhost Mode](https://developers.hint.com/docs/localhost-mode.md): Route your product's handshake, app surfaces, activation redirect, and webhooks to a server on your own machine. No tunnel, no hosted dev server. - [Managing Your Listing](https://developers.hint.com/docs/managing-your-listing.md): How the pieces of a marketplace listing fit together under the /api/partner surface. - [Partner Asset Guidelines](https://developers.hint.com/docs/partner-asset-guidelines.md): To ensure your integration looks great across the Hint Marketplace, please provide the following visual assets. These assets may be used across various product and branding contexts, now and in the… ## Guides: Practice API Access - [Getting Sandbox and API Access](https://developers.hint.com/docs/requesting-a-sandbox-and-api-access.md): Decide between API Access and the Data Exporter, then turn API Access on yourself from Admin > Developers. - [Setting up your Sandbox Account & API Keys](https://developers.hint.com/docs/setting-up-your-sandbox-account-api-keys.md) ## Guides: Detailed Workflows - [Creating A Custom Signup Page](https://developers.hint.com/docs/creating-a-custom-signup-page.md): How to orchestrate plans, patients, memberships, and payments outside Hint’s hosted signup form. - [Creating Charges and Invoices](https://developers.hint.com/docs/creating-charges-and-invoices.md): Route partner-supplied charges through Hint’s pricing engine and collect invoices confidently. - [Correcting, Refunding, and Voiding Invoices](https://developers.hint.com/docs/correcting-refunding-and-voiding-invoices.md): Which API calls to make, in which order, to fix a charge, refund a payment, or void a customer invoice in each invoice status. - [Recurring Appointments](https://developers.hint.com/docs/recurring-appointments.md): How Hint represents recurring appointments in the public API, and why occurrences of the same series can show different statuses - or more than one entry for the same date. - [Collecting payment information (Hint Payments)](https://developers.hint.com/docs/collecting-payment-information-hint-payments.md): Use Rainforest’s Payment Component with Hint’s setup endpoint to collect cards and ACH safely. - [Collecting payment information (Stripe)](https://developers.hint.com/docs/collecting-payment-information-using-stripes-financial-connections.md): If you are using Hint Payments, please refer to that guide. - [Prescriptions and Medications](https://developers.hint.com/docs/prescriptions-and-medications.md): When to create a prescription and when to create a medication, so the same drug is never written to a patient chart twice. - [Lab Requisitions and Results](https://developers.hint.com/docs/lab-requisitions-and-results.md): Attach the order paperwork and the lab report to a Lab Interaction, and read back which document is which. ## API Reference: Getting Started - [Making Requests](https://developers.hint.com/reference/making-requests.md): Authentication, Pagination, Rate Limits, Headers - [Webhooks](https://developers.hint.com/reference/webhooks.md): Event delivery, payload format, retries, signature validation - [Shared Objects](https://developers.hint.com/reference/shared-objects.md): Common object structures embedded across multiple API resources ## API Reference: Patients - [List All Patients](https://developers.hint.com/reference/patientlistallpatients-1.md): **Note:** Archived patients are excluded from responses by default. Use `filter=archived` to return only archived patients. - [Create Patient](https://developers.hint.com/reference/patientcreatepatient-1.md) - [Match Patients](https://developers.hint.com/reference/patientmatchpatients-1.md) - [Show Patient](https://developers.hint.com/reference/patientshowpatient-1.md): **Membership Status Options:** unconfirmed, pending, active, unpaid, inactive, archived - [Update Patient](https://developers.hint.com/reference/patientupdatepatient-1.md) - [Delete Patient](https://developers.hint.com/reference/patientdeletepatient-1.md) - [Show Social Security Number](https://developers.hint.com/reference/socialsecuritynumbershowsocialsecuritynumber-1.md) - [List all IntegrationRecords for a Patient](https://developers.hint.com/reference/integrationrecordlistallintegrationrecords-1.md) - [Show Patient Affiliate](https://developers.hint.com/reference/affiliateshowpatientaffiliate.md): Returns `null` when the patient has no assigned affiliate. - [List All Form Responses](https://developers.hint.com/reference/formresponselistallformresponses-1.md) - [Show Form Response](https://developers.hint.com/reference/formresponseshowformresponse-1.md) ## API Reference: Memberships & Config - [List All Coupons](https://developers.hint.com/reference/couponlistallcoupons-1.md) - [Show Coupon](https://developers.hint.com/reference/couponshowcoupon-1.md) - [List All CancellationReasons](https://developers.hint.com/reference/cancellationreasonlistcancellationreasons-1.md) - [List All Lead Sources](https://developers.hint.com/reference/leadsourceleadsources-1.md) - [Create LeadSource](https://developers.hint.com/reference/leadsourceleadsource-1.md) - [Update Lead Source](https://developers.hint.com/reference/leadsourceupdateleadsource-1.md) - [Delete Lead Source](https://developers.hint.com/reference/leadsourcedeleteleadsource-1.md) - [List All Memberships](https://developers.hint.com/reference/membershiplistallmemberships-1.md) - [Create Membership](https://developers.hint.com/reference/membershipcreatemembership-1.md): Patients synced from a network cannot be enrolled by the affiliate practice: creating a membership for one returns 409 "This patient is synced from a Network". Contact the network to enroll them. - [New Membership](https://developers.hint.com/reference/membershipnewmembership-1.md): Builds a default membership - [Show Membership](https://developers.hint.com/reference/membershipshowmembership-1.md): **Status Options:** pending, unconfirmed, active, unpaid, ended **Enrollment Status Options:** pending, unconfirmed, active, inactive - [Update Membership](https://developers.hint.com/reference/membershipupdatemembership-1.md) - [Delete Membership](https://developers.hint.com/reference/membershipdeletemembership-1.md) - [Bill Membership](https://developers.hint.com/reference/membershipbillmembership-1.md) - [Cancel Membership](https://developers.hint.com/reference/membershipcancelmembership-1.md) - [Confirm Membership](https://developers.hint.com/reference/membershipconfirmmembership.md): Confirms an unconfirmed membership so it starts billing, and sends the patient the membership created email. Confirming an already confirmed membership is a no-op. Memberships synced from a network… - [List All MembershipMembers](https://developers.hint.com/reference/membershipmemberlistmembershipmembers-1.md) - [Create MembershipMember](https://developers.hint.com/reference/membershipmembercreatemembershipmember-1.md) - [Show MembershipMember](https://developers.hint.com/reference/membershipmembershowmembershipmember-1.md) - [Update Member](https://developers.hint.com/reference/membershipmemberupdatemembershipmember-1.md) - [Destroy MembershipMember](https://developers.hint.com/reference/membershipmemberdestroymembershipmember-1.md) - [Cancel MembershipMember](https://developers.hint.com/reference/membershipmembercancelmembershipmember-1.md) - [List all Membership Contracts](https://developers.hint.com/reference/membershipcontractlistallmembershipcontracts-1.md) - [Renew Membership Contract](https://developers.hint.com/reference/membershipcontractrenewmembershipcontract-1.md) - [Update Membership Contract](https://developers.hint.com/reference/membershipcontractupdatemembershipcontract-1.md) - [List All Plans](https://developers.hint.com/reference/planlistallplans-1.md) - [Create Quote](https://developers.hint.com/reference/quotecreatequote-1.md) ## API Reference: Patient Charges, Invoices, Credits - [List All Payment Methods](https://developers.hint.com/reference/paymentmethodlistallpaymentmethods-1.md) - [Create Payment Method](https://developers.hint.com/reference/paymentmethodcreatepaymentmethod-1.md): Exactly one of `rainforest_id` or `stripe_id` must be provided. Practices on Hint Payments (Rainforest) submit a `rainforest_id`; practices on Stripe submit a `stripe_id`. - [Create Setup Intent](https://developers.hint.com/reference/paymentmethodcreatesetupintent-1.md): The response shape depends on the practice's payment processor (`payment_processor` in the response): - When `rainforest`: `payment_method_config_id`, `session_key`, and `allowed_methods` are… - [Show Payment Method](https://developers.hint.com/reference/paymentmethodshowpaymentmethod-1.md) - [Delete Payment Method](https://developers.hint.com/reference/paymentmethoddeletepaymentmethod-1.md) - [List All Charge Items](https://developers.hint.com/reference/chargeitemlistallchargeitems-1.md): Charges will only include the 'quantity_in_stock' if their charge item is configured to track inventory - [Create Charge Item](https://developers.hint.com/reference/chargeitemcreatechargeitem-1.md) - [Show Charge Item](https://developers.hint.com/reference/chargeitemshowchargeitem-1.md): Charge will only include the 'quantity_in_stock' if its charge item is configured to track inventory. - [Update Charge Item](https://developers.hint.com/reference/chargeitemupdatechargeitem-1.md) - [Delete Charge Item](https://developers.hint.com/reference/chargeitemdeletechargeitem-1.md) - [Create Charge](https://developers.hint.com/reference/chargecreatecharge-1.md) - [List All Credit Categories](https://developers.hint.com/reference/creditcategorylistcreditcategories-1.md) - [Create Credit Category](https://developers.hint.com/reference/creditcategorycreatecreditcategory-1.md) - [Show Credit Category](https://developers.hint.com/reference/creditcategoryshowcreditcategory-1.md) - [Update Credit Category](https://developers.hint.com/reference/creditcategoryupdatecreditcategory-1.md) - [Delete Credit Category](https://developers.hint.com/reference/creditcategorydeletecreditcategory-1.md) - [List All Customer Invoices](https://developers.hint.com/reference/customerinvoicelistallcustomerinvoices-1.md): To filter by several statuses, repeat the `status` parameter with brackets, such as `status[]=issued&status[]=sent`. - [Create Customer Invoice](https://developers.hint.com/reference/customerinvoicecreatecustomerinvoice-1.md) - [Generate PDF for Customer Invoice](https://developers.hint.com/reference/customerinvoicecreatepdf-1.md): ## Usage Instructions and Security Best Practices - **Link Expiration:** Links expire after 15 minutes. - **Authenticate Users:** Only generate pdf links for authenticated users. - **On-Demand… - [Show Customer Invoice](https://developers.hint.com/reference/customerinvoiceshowcustomerinvoice-1.md): **Status Options:** draft, issued, sent, cancelled, retrying, bad_debt, paid, disputed **Human Status Options:** draft, issued, sent, cancelled, bank_not_verified, needs_payment_info, retrying,… - [Update Customer Invoice](https://developers.hint.com/reference/customerinvoiceupdatecustomerinvoice-1.md) - [Delete Customer Invoice](https://developers.hint.com/reference/customerinvoicedeletecustomerinvoice-1.md): Allowed for a `draft` invoice, and for a `cancelled` (voided) or zero-total invoice that has no payments. Any other invoice fails with `400 This customer invoice cannot be deleted because it still… - [Issue Customer Invoice](https://developers.hint.com/reference/customerinvoiceissuecustomerinvoice-1.md) - [Return Customer Invoice To Draft](https://developers.hint.com/reference/customerinvoicereturntodraft-1.md): Return to draft removes the financial information including revenue from all reports and restores the prepaid package reservations and charge-item inventory consumed at issue. Allowed from `issued`,… - [Void Customer Invoice](https://developers.hint.com/reference/customerinvoicevoidcustomerinvoice-1.md): Voids an `issued`, `sent`, `retrying`, `paid`, or `bad_debt` invoice and sets its status to `cancelled`. A `draft` or `disputed` invoice can not be voided; delete a draft instead. The invoice must… - [Email Customer Invoice](https://developers.hint.com/reference/customerinvoicesendcustomerinvoiceemail.md): Emails the customer invoice to its owner (the patient), the same email a provider can send from the invoice screen in Hint. Use this to deliver an API-generated invoice to the patient. Returns a 422… - [Create CustomerInvoiceCharge](https://developers.hint.com/reference/customerinvoicechargecreatecustomerinvoicecharge-1.md): The invoice must be in `draft` status. Adding a charge to an issued invoice fails with `422 Invoice must be in draft status`; return the invoice to draft first. - [Update CustomerInvoiceCharge](https://developers.hint.com/reference/customerinvoicechargeupdatecustomerinvoicecharge-1.md): Only the fields that are editable in the invoice's current status are applied. Fields that are not editable are ignored without an error: the response is `200` and shows the unchanged values, so… - [Delete CustomerInvoiceCharge](https://developers.hint.com/reference/customerinvoicechargedeletecustomerinvoicecharge-1.md): The invoice must be in `draft` status. Deleting a charge from an issued invoice fails with `422 Invoice must be in draft status`; return the invoice to draft first. Deleting a charge releases any… - [List All Payments](https://developers.hint.com/reference/customerinvoicepaymentlistallpayments-1.md) - [Create Payment](https://developers.hint.com/reference/customerinvoicepaymentcreatepayment-1.md): Payments can be created only against an `issued`, `sent`, `retrying`, or `bad_debt` invoice; any other status fails with `422 Invoice is not payable`. An invoice can not be overpaid: an… - [Show Payment](https://developers.hint.com/reference/customerinvoicepaymentshowpayment-1.md) - [List All Credits](https://developers.hint.com/reference/creditlistallcredits-1.md) - [Create Credit](https://developers.hint.com/reference/creditcreatecredit-1.md) - [Update Credit](https://developers.hint.com/reference/creditupdatecredit-1.md) ## API Reference: Patient Clinical - [Create Clinical Note Interaction](https://developers.hint.com/reference/clinicalnoteinteractioncreateclinicalnoteinteraction.md) - [Show Clinical Note Interaction](https://developers.hint.com/reference/clinicalnoteinteractionshowclinicalnoteinteraction.md) - [Update Clinical Note Interaction](https://developers.hint.com/reference/clinicalnoteinteractionupdateclinicalnoteinteraction.md) - [Create Document Interaction](https://developers.hint.com/reference/documentinteractioncreatedocumentinteraction.md) - [Show Document Interaction](https://developers.hint.com/reference/documentinteractionshowdocumentinteraction.md) - [Update Interaction](https://developers.hint.com/reference/documentinteractionupdatedocumentinteraction.md) - [Create Partner Interaction](https://developers.hint.com/reference/partnerinteractioncreatepartnerinteraction.md) - [Show Partner Interaction](https://developers.hint.com/reference/partnerinteractionshowpartnerinteraction.md) - [Update Partner Interaction](https://developers.hint.com/reference/partnerinteractionupdatepartnerinteraction.md) - [Create Lab Interaction](https://developers.hint.com/reference/labinteractioncreatelabinteraction.md) - [Show Lab Interaction](https://developers.hint.com/reference/labinteractionshowlabinteraction.md) - [Update Lab Interaction](https://developers.hint.com/reference/labinteractionupdatelabinteraction.md) - [Create Patient Prescription](https://developers.hint.com/reference/prescriptionscreateprescription.md) - [List Patient Medications](https://developers.hint.com/reference/medicationslistallpatientmedications.md) - [Create Patient Medication](https://developers.hint.com/reference/medicationscreatemedication.md) - [Show Patient Medication](https://developers.hint.com/reference/medicationsshowmedication.md) - [Update Patient Medication](https://developers.hint.com/reference/medicationsupdatemedication.md) - [Delete Patient Medication](https://developers.hint.com/reference/medicationsdeletemedication.md) - [List Patient Supplements](https://developers.hint.com/reference/supplementslistallpatientsupplements.md) - [Create Patient Supplement](https://developers.hint.com/reference/supplementscreatesupplement.md) - [Show Patient Supplement](https://developers.hint.com/reference/supplementsshowsupplement.md) - [Update Patient Supplement](https://developers.hint.com/reference/supplementsupdatesupplement.md) - [Delete Patient Supplement](https://developers.hint.com/reference/supplementsdeletesupplement.md) ## API Reference: Practice Clinical - [List All Appointments](https://developers.hint.com/reference/appointmentlistallappointments.md): Declined appointments are not returned by this endpoint. Recurring appointments are stored once and expanded into one appointment object per occurrence that falls within `start_date`/`end_date`.… - [List All Appointment Types](https://developers.hint.com/reference/appointmentlistallappointmenttypes.md): Returns the practice's active appointment types. Inactive, archived, and deleted appointment types are excluded. As a result, an appointment's `appointment_type_id` may reference a type that no… - [List All Interactions](https://developers.hint.com/reference/interactionlistallinteractions.md) - [Create Interaction Notification](https://developers.hint.com/reference/interactionnotificationscreateinteractionnotification.md) - [List Patient Refill Notifications](https://developers.hint.com/reference/refillnotificationslistallpatientrefillnotifications.md) - [Create Patient Refill Notification](https://developers.hint.com/reference/refillnotificationscreaterefillnotification.md) - [Show Patient Refill Notification](https://developers.hint.com/reference/refillnotificationsshowrefillnotification.md) - [Update Patient Refill Notification](https://developers.hint.com/reference/refillnotificationsupdaterefillnotification.md) - [Dismiss Patient Refill Notification](https://developers.hint.com/reference/refillnotificationsdeleterefillnotification.md) ## API Reference: Practice Config & Settings - [List All Locations](https://developers.hint.com/reference/locationlistlocations-1.md) - [Create Location](https://developers.hint.com/reference/locationcreatelocation-1.md) - [Show Location](https://developers.hint.com/reference/locationshowlocation-1.md) - [Update Location](https://developers.hint.com/reference/locationupdatelocation-1.md) - [Delete Location](https://developers.hint.com/reference/locationdeletelocation-1.md) - [Get Practice](https://developers.hint.com/reference/practicegetpractice-1.md) - [Update Practice](https://developers.hint.com/reference/practiceupdatepractice-1.md) - [List All Practitioners](https://developers.hint.com/reference/practitionerproviderpractitioners-1.md) - [Create Practitioner](https://developers.hint.com/reference/practitionercreatepractitioner-1.md) - [Show Practitioner](https://developers.hint.com/reference/practitionershowpractitioner-1.md) - [Update Practitioner](https://developers.hint.com/reference/practitionerupdatepractitioner-1.md) - [Delete Practitioner](https://developers.hint.com/reference/practitionerdeletepractitioner-1.md) - [List Users](https://developers.hint.com/reference/userlistusers.md) ## API Reference: Company - Sponsorshps, Invoices, Plans - [List All Companies](https://developers.hint.com/reference/companylistallcompanies-1.md) - [Create Company](https://developers.hint.com/reference/companycreatecompany-1.md) - [Show Company](https://developers.hint.com/reference/companyshowcompany-1.md) - [Update Company](https://developers.hint.com/reference/companyupdatecompany-1.md) - [Deactivate Company](https://developers.hint.com/reference/companydeactivatecompany-1.md) - [List All Employee Divisions](https://developers.hint.com/reference/employeedivisionlistallemployeedivisions-1.md) - [List All Company Plans](https://developers.hint.com/reference/companyplanlistcompanyplans-1.md) - [Create Company Plan](https://developers.hint.com/reference/companyplancreatecompanyplan-1.md) - [Update Company Plan](https://developers.hint.com/reference/companyplanupdatecompanyplan-1.md) - [Destroy CompanyPlan](https://developers.hint.com/reference/companyplandestroycompanyplan-1.md) - [List All Invoices](https://developers.hint.com/reference/invoicelistallinvoices-1.md) - [Show Invoice](https://developers.hint.com/reference/invoiceshowinvoice-1.md) - [List All Payments](https://developers.hint.com/reference/invoicepaymentlistallpayments-1.md) - [Create Payment](https://developers.hint.com/reference/invoicepaymentcreatepayment-1.md): Payments can be created only against an `issued`, `sent`, `retrying`, or `bad_debt` invoice; any other status fails with `422 Invoice is not payable`. An invoice can not be overpaid: an… - [Show Payment](https://developers.hint.com/reference/invoicepaymentshowpayment-1.md) - [List All Sponsorhips](https://developers.hint.com/reference/sponsorshiplistsponsorships-1.md) - [Create Sponsorship](https://developers.hint.com/reference/sponsorshipcreatesponsorship-1.md) - [Show Sponsorship](https://developers.hint.com/reference/sponsorshipshowsponsorhip-1.md) - [Update Sponsorship](https://developers.hint.com/reference/sponsorshipupdatesponsorship-1.md) - [Destroy Sponsorship](https://developers.hint.com/reference/sponsorshipdestroysponsorship-1.md): If the subscriber is destroyed all dependents will be destroyed. ## API Reference: Networks & Affiliates - [List All Affiliate Bills](https://developers.hint.com/reference/affiliatebilllistaffiliatebills-1.md) - [Assign patient to an affiliation](https://developers.hint.com/reference/affiliatepatientcreateaffiliatepatient-1.md) - [Remove patient from an affiliation](https://developers.hint.com/reference/affiliatepatientdestroyaffiliatepatient-1.md) - [List All Affiliates](https://developers.hint.com/reference/affiliatelistaffiliates-1.md) ## API Reference: Reporting - [List All Signup Attempts](https://developers.hint.com/reference/signupattemptlistsignupattempts-1.md) - [Show Signup Attempt](https://developers.hint.com/reference/signupattemptshowsignupattempt-1.md) - [List All Credit Lines](https://developers.hint.com/reference/creditlinelistcreditlines-1.md) ## API Reference: Partner Endpoints - [List API Keys](https://developers.hint.com/reference/apikeylistapikeys.md) - [Create API Key](https://developers.hint.com/reference/apikeycreateapikey.md): The full `token` value is only returned in this response. Store it securely — it cannot be retrieved later. - [Show Partner](https://developers.hint.com/reference/partnershowpartner-1.md) - [Update Partner](https://developers.hint.com/reference/partnerupdatepartner-1.md) - [List Partner Backends](https://developers.hint.com/reference/backendlistbackends.md): Each backend owns its own webhook delivery, OAuth config, and product catalog. - [Show Partner Backend](https://developers.hint.com/reference/backendshowbackend.md) - [Update Partner Backend](https://developers.hint.com/reference/backendupdatebackend.md) - [Deactivate Installation](https://developers.hint.com/reference/installationdeactivateinstallation.md): Deactivates the installation. The practice's other installations are not affected. - [Activate Installation](https://developers.hint.com/reference/installationactivateinstallation.md): Activates a pending installation. The practice must have activated the connection first; the connection is activated as part of this call if it is not already active. - [Connect Installation](https://developers.hint.com/reference/installationconnectinstallation.md): Exchanges the authorization code issued when the practice installed the product and returns the installation with the API credentials the practice's app uses to authenticate its requests. - [List Installations](https://developers.hint.com/reference/installationlistinstallations.md): Returns the partner's installations — one per (product × practice connection). Each row carries the connected practice and product and survives the install/uninstall cycle (deactivated installs are… - [Show Installation](https://developers.hint.com/reference/installationshowinstallation.md): Returns a single installation by id. Deactivated installations are also returned — uninstall is reactivation-shaped, so a partner can inspect the durable per-product install row across the… - [List Installation Webhook Endpoints](https://developers.hint.com/reference/installationwebhookendpointslistwebhookendpoints.md): Lists the webhook endpoints registered on this installation's practice connection. Endpoints are connection-scoped, so installs of the same practice's products share them. - [Create Installation Webhook Endpoint](https://developers.hint.com/reference/installationwebhookendpointscreatewebhookendpoint.md) - [Update Installation Webhook Endpoint](https://developers.hint.com/reference/installationwebhookendpointsupdatewebhookendpoint.md) - [Delete Installation Webhook Endpoint](https://developers.hint.com/reference/installationwebhookendpointsdeletewebhookendpoint.md) - [List Installation API Keys](https://developers.hint.com/reference/installationapikeyslistapikeys.md): Lists the API keys for this installation's practice connection. Keys are connection-scoped, so installs of the same practice's products share them. - [Create Installation API Key](https://developers.hint.com/reference/installationapikeyscreateapikey.md): The full `token` value is only returned in this response. Store it securely — it cannot be retrieved later. - [Update Installation API Key](https://developers.hint.com/reference/installationapikeysupdateapikey.md) - [Delete Installation API Key](https://developers.hint.com/reference/installationapikeysdeleteapikey.md) - [Push Practice Credential](https://developers.hint.com/reference/partnerpracticecredentialpushpartnerpracticecredential.md): The partner pushes (or rotates) the credential a practice's custom app uses to call the partner's API, for a specific installation. The credential is held on the installation's integration, so… - [Retrieve Practice Credential](https://developers.hint.com/reference/partnerpracticecredentialgetpartnerpracticecredential.md): Returns the active credential Hint holds for this installation's integration. The credential payload itself is never returned — the partner supplied it, so echoing it back would only widen where the… - [Revoke Practice Credential](https://developers.hint.com/reference/partnerpracticecredentialrevokepartnerpracticecredential.md): Deactivates the active credential on this installation's integration. The record is kept for audit; it stops satisfying the active lookup, which frees the integration for a fresh push. Installations… - [List Products](https://developers.hint.com/reference/productlistproducts.md) - [Create Product](https://developers.hint.com/reference/productcreateproduct.md) - [Get Product](https://developers.hint.com/reference/productgetproduct.md) - [Update Product](https://developers.hint.com/reference/productupdateproduct.md) - [Destroy Product](https://developers.hint.com/reference/productdestroyproduct.md) - [Request Product Review](https://developers.hint.com/reference/productrequestproductreview.md) - [List Available Product Categories](https://developers.hint.com/reference/productcategorylistavailableproductcategories.md): Flat list of all marketplace categories currently in use. Useful for partners picking which categories to attach to their product — pick from this list to align with existing marketplace browse, or… - [List Product Categories](https://developers.hint.com/reference/productcategorylistproductcategories.md) - [Attach Product Category](https://developers.hint.com/reference/productcategoryattachproductcategory.md): Attach a category to the product, either by `category_id` (an existing category from `GET /partner/products/categories`) or by `name`. A name must match an existing category — partners cannot mint… - [Detach Product Category](https://developers.hint.com/reference/productcategorydetachproductcategory.md): Detach the category from the product. The category itself is preserved (other products may still be using it). - [List Product Testimonials](https://developers.hint.com/reference/testimoniallistproducttestimonials.md) - [Create Product Testimonial](https://developers.hint.com/reference/testimonialcreateproducttestimonial.md) - [Update Product Testimonial](https://developers.hint.com/reference/testimonialupdateproducttestimonial.md) - [Destroy Product Testimonial](https://developers.hint.com/reference/testimonialdestroyproducttestimonial.md) - [List Product Links](https://developers.hint.com/reference/partnerproductlinklistproductlinks.md) - [Create Product Link](https://developers.hint.com/reference/partnerproductlinkcreateproductlink.md) - [Update Product Link](https://developers.hint.com/reference/partnerproductlinkupdateproductlink.md) - [Destroy Product Link](https://developers.hint.com/reference/partnerproductlinkdestroyproductlink.md) - [List Product Highlights](https://developers.hint.com/reference/partnerproducthighlightlistproducthighlights.md) - [Create Product Highlight](https://developers.hint.com/reference/partnerproducthighlightcreateproducthighlight.md) - [Update Product Highlight](https://developers.hint.com/reference/partnerproducthighlightupdateproducthighlight.md) - [Destroy Product Highlight](https://developers.hint.com/reference/partnerproducthighlightdestroyproducthighlight.md) - [Get Product Overview](https://developers.hint.com/reference/partnerproductoverviewgetproductoverview.md) - [Update Product Overview](https://developers.hint.com/reference/partnerproductoverviewupdateproductoverview.md) - [List Product Preconditions](https://developers.hint.com/reference/partnerproductpreconditionlistproductpreconditions.md) - [Create Product Precondition](https://developers.hint.com/reference/partnerproductpreconditioncreateproductprecondition.md) - [Update Product Precondition](https://developers.hint.com/reference/partnerproductpreconditionupdateproductprecondition.md) - [Destroy Product Precondition](https://developers.hint.com/reference/partnerproductpreconditiondestroyproductprecondition.md) - [Create App Surface](https://developers.hint.com/reference/appsurfacecreateproductappsurface.md) - [Update App Surface](https://developers.hint.com/reference/appsurfaceupdateproductappsurface.md) - [Delete App Surface](https://developers.hint.com/reference/appsurfacedeleteproductappsurface.md) - [Get App](https://developers.hint.com/reference/appgetproductapp.md) - [Update App](https://developers.hint.com/reference/appupdateproductapp.md) - [Create App](https://developers.hint.com/reference/appcreateproductapp.md) - [List Webhook Event Types](https://developers.hint.com/reference/webhookeventlistwebhookevents.md): Returns the canonical list of event types delivered to partner webhook endpoints — every string is a `resource.action` pair (e.g. `patient.created`, `customer_invoice.paid`, `membership.updated`).… - [List Webhook Endpoints](https://developers.hint.com/reference/webhookendpointlistwebhookendpoints.md) - [Create Webhook Endpoint](https://developers.hint.com/reference/webhookendpointcreatewebhookendpoint-1.md): Registers a URL to receive events for every integration tied to this partner. There is no per-endpoint event filter — a registered endpoint receives the full set of events the partner's integrations… - [Update Webhook Endpoint](https://developers.hint.com/reference/webhookendpointupdatewebhookendpoint-1.md) - [Delete Webhook Endpoint](https://developers.hint.com/reference/webhookendpointdeletewebhookendpoint-1.md) - [List Webhook Requests](https://developers.hint.com/reference/webhookrequestlistwebhookrequests.md) - [List All Affiliate Ancillary Charges](https://developers.hint.com/reference/affiliateancillarychargelistaffiliateancillarycharges.md): Returns the network's ancillary charges aggregated across every affiliate, newest first. Supports pagination through `limit` (default 10, min 1, max 100) and `offset` (default 0, min 0). Sortable… - [List Interaction File Download URLs](https://developers.hint.com/reference/interactionfilelistinteractionfiledownloadurls.md): Returns a short-lived, single-use download URL for every file attached to the interaction. Only PDFs are downloadable; other file types are listed with a null url. The URLs cannot be saved and… - [Delete Interaction File](https://developers.hint.com/reference/interactionfiledeleteinteractionfile.md): Removes one file from the interaction, addressed by its id. Responds 404 when the id does not match a file on the interaction, and 422 when the file predates typed files: that kind is cleared with… - [Get Interaction File Download URL](https://developers.hint.com/reference/interactionfilegetinteractionfiledownloadurl.md): Returns a short-lived, single-use download URL for one file on the interaction, addressed by its id. Responds 404 when the id does not match a file on the interaction, and 422 when the file is not a… - [List All Partner Charges](https://developers.hint.com/reference/partnerchargelistallpartnercharges.md) - [Create Partner Charge](https://developers.hint.com/reference/partnerchargecreatepartnercharge.md): **Workflows:** Charging a patient: Set the payer to the be the patient. Charging a patient: Set the payer to the be practice. - [Show Partner Charge](https://developers.hint.com/reference/partnerchargeshowpartnercharge.md) - [Create Patient Portal access token](https://developers.hint.com/reference/accountaccesstokencreateacccesstoken-1.md): ## Usage Instructions and Security Best Practices - **Authenticate Patients:** Only generate access tokens for patients that your system has already authenticated. - **On-Demand Links:** Generate… - [Delete Prospect](https://developers.hint.com/reference/prospectdeleteprospect.md)