FAQs

Currently our integration is manual, but we'd like to enable automatic integrations. How do we setup the automatic integrations?

Once your 'Instant-On' implementation is completed, contact us as [email protected]. We will confirm that your implementation works in our staging environment then, when you're ready, enable automatic integrations for all our customers. You can read more about 'Instant-On here: https://developers.hint.com/docs/instanton-via-oauth

Do you have a list of all events for which we can get the data events sent to our system through Webhook Requests?

https://developers.hint.com/docs/webhooks#section-what-events-get-sent-out

What is the expiration time of the access tokens? Is it possible to refresh the access token using a refresh token?

Currently, our OAuth access tokens do not expire and do not need to be refreshed. A practice can, at any time, disable an integration which will expire your access token. In this case we do not allow the access tokens to be refreshed. A token can also be expired manually on your request.

All practices use the same instance of our application, do we need a different integration_id for each practice?

Yes, you do. We OAuth separately for each practice, and determine the practice associated with each request from the OAuth Access Token. We've considered also supporting authentication of the Provider endpoints using your Partner API KEY and specifying the Practice using a custom header, instead of using the per-practice Access Token. If that would be a better approach for you, please let us know so that we can prioritize adding that functionality.

Is the Access Token we receive from the OAuth interface needed for any other GET/POST/PATCH requests that we make with the integration_id?

In short, no.
The /api/integrations and /api/oath endpoints (and a few others) require your Partner API key. Your OAuth Access Token is required to access any URL that starts with /api/provider, which we call our Provider namespace. You can read more about how our namespaces and authentication work in the overview https://developers.hint.com/docs/overview

The API exposes only the practice name and id, is there a way to get more practice data from the API?

Not currently. Please let us know if you'd like to see this added to our API and what you'd like to use it for as it will help us prioritize adding this functionality.

Is there any way of getting all providers data through the API such as Specialties and Education?

Not currently. Please let us know if you'd like to see this added to our API and what you'd like to use it for as it will help us prioritize adding this functionality.

When a provider terminates an integration, do we let the partner know somehow?

Yes, We notify the partner using a webhook.