HIPAA and the Knack API

Understand the security risks and responsibilities of using the Knack API with PHI — including the USGC endpoint, field-level access limitations, key rotation, and third-party integrations.

What You'll Learn

This article covers what you need to know about using the Knack API on a HIPAA plan. The API is a powerful tool for accessing and managing your data, but it also introduces risks that you're responsible for managing. This article explains those risks and how to handle them.

Your Responsibility

The Knack API gives you direct access to your app's data. That includes any PHI stored in your tables. Knack has no ability to limit or enforce restrictions on which data can or cannot be accessed through the API.

You are solely responsible for any API usage that leads to PHI breaches or security compromises.

This is not a platform limitation you can work around — it's how APIs work. The API returns data based on what you request, and it's up to you to make sure your requests, your code, and your integrations handle that data appropriately.

Use the Right API Address for Your HIPAA App

Which API address your app uses depends on when it moved to Knack's HIPAA environment.

When your app moved to HIPAAAPI address to use
Before July 1, 2026usgc-api.knack.com
On or after July 1, 2026api.knack.com (no change needed)

If your app moved before July 1, 2026, calls to api.knack.com won't work. Update any custom code, integrations, or third-party tools to usgc-api.knack.com.

⚠️

Not sure when your app moved?

Contact Knack support before changing any integration. Pointing an app at the wrong address stops sign-in and data from working.

Field-Level Access Limitations

The Knack API does not support field-level access restrictions. When you request a record, the API returns all fields that the authenticated user has access to. You cannot exclude specific fields from the response at the API level.

This means:

  • If a table contains both clinical notes and billing codes, an API request for records in that table returns both — even if the integration only needs billing codes
  • You're responsible for filtering out unnecessary fields in your code before passing data downstream
  • The Minimum Necessary Rule still applies: only use and forward the fields you actually need

Never Expose API Keys in Client-Side Code

Your API key is the credential that grants access to your data. If it's exposed, anyone who has it can read, write, update, and delete records in your app.

  • Don't include your API key in client-side JavaScript. Browser-based code is visible to anyone using developer tools.
  • Use view-based API requests for any operations that run in the browser. View-based requests are scoped to the logged-in user's permissions and don't expose your API key.
  • Store API keys server-side in environment variables or a secrets manager. Never hard-code them in your codebase.

Rotate API Keys Regularly

API keys should be rotated at least annually. Treat your API key like a password — if it's been in use for a long time, if someone who had access to it leaves your organization, or if you suspect it may have been compromised, rotate it immediately.

Third-Party Services and the API

If you use the API to send data to third-party services (analytics platforms, email providers, reporting tools, etc.), you need to verify that those services handle PHI appropriately.

  • Before sending data to any external service via the API, confirm that the service is HIPAA compliant and that you have a BAA in place with them
  • Knack cannot guarantee the security of your data once it leaves the Knack environment
  • If you're emailing, exporting, or transmitting PHI through the API to a third party, the security of that data is entirely your responsibility

This also applies to Flows. If a Flow sends data from your Knack app to an external service, the same rules apply — verify compliance before connecting.

For more on third-party tools, see Flows and Third-Party Compliance.

Summary

AreaWhat You Need to Do
API Endpointusgc-api.knack.com if your app moved to HIPAA before July 1, 2026. Otherwise, api.knack.com.
Field-Level AccessFilter unnecessary fields in your code — the API returns everything
API Key ExposureNever put keys in client-side code; use view-based requests or server-side storage
Key RotationRotate at least annually; immediately if compromised
Third-Party ServicesVerify HIPAA compliance and BAA before sending PHI

Next Steps

⚠️

This is not legal advice. Knack provides a HIPAA-eligible platform. Confirming your own compliance obligations is your responsibility. Check with your legal counsel or compliance officer.


Did this page help you?