BetterWorks

Using Betterworks API

BetterWorks API 

Note: API key access is only available to Super Admins in BetterWorks

BetterWorks has an API to allow applications to programmatically access and update data within BetterWorks. Documentation and technical details for the API can be found at developers.betterworks.com.

Any application can use the API as long as every request to the API has an active API key.  

API keys are tied to activated users in BetterWorks. The data available to the application is based on the permissions of the user. Below are the steps to generate an API key:

- Navigate to the BetterWorks API page by going to Admin > BetterWorks API

- Search for a user to link an API key to. The data available to the application using the API key will be based on the selected user.

NOTE: If you do not want to link an API key to an actual employee, you can create a fictitious user in the “Manage Departments and Users” section of the admin portal. You can name the user with a description of the application using the API key (e.g., First Name: Reporting Application).

- Assign the API key a unique name. The same user can have multiple keys.

- Click “Generate Key”

- The API key will be generated and will be shown under “Active Keys.” The key will need to be included in every API call to the BetterWorks platform.

Revoking a Key

An API key can be revoked at any time

- Navigate to the BetterWorks API page by going to Admin > BetterWorks API

- Click “Revoke” for the API key you wish to revoke in “Active keys”

- The API key will be immediately deactivated

- The API key can be reactivated at any time by clicking “Reactivate” in “Deactivated keys”

 

Was this article helpful?
0 out of 0 found this helpful
Have more questions? Submit a request

Comments