You can manage your APIs in BestNotes. Our BestNotes API will give you examples of what our API will provide. This document will show you how to add API credentials, and how to Whitelist IP Addresses.

Permissions required

To add API Credentials to BestNotes, you need the "Manage API" permission.

Add credentials

1. Navigate to "Settings", then "APIs."
2. Select "Add Credentials" to create a new set of credentials.
3. Add in your "Usage Notes." This field is required.
4. Select if you want to "Show Identifying PHI." If you select yes, you are allowing Contact information to display through the API, and this sensitive information needs to be populated through a secure HIPAA compliant method.
5. Then you will select "Permission." This field is required.
6. Select "Add."
7. You will receive an alert letting you know that the "API credentials saved." Select "OK."
8. You will only be able to view and save the "Private Key" this one time. Be sure to store it in a secure location. Do not email public and private keys. These keys need to be sent to a developer of your choosing via a secure HIPAA compliant method. You can copy the keys by selecting the copy icon on the right.
9. When you are ready, select "Save."
10. You will receive another alert letting you know the "API credentials saved." Select "OK."

Edit credentials

1. To view and edit an existing set, select the entry.
2. You will have the ability to copy the "Public Key", or to update the "Usage Notes." 
3. Once a call is made using the set of keys, you will have the ability to  whitelist the IP address that was used. In the "Whitelist IP Addresses" section, select the checkbox next to each IP address that you would like to whitelist. If you add an IP address to be whitelisted, only the IP addresses selected will have access to the API.
4. Select "Save" when ready.

Delete credentials

1. For the entry that you would like to delete, select the trash can icon.