A Wrapper to the 'BambooHR' API

Enables a user to consume the 'BambooHR' API endpoints using R. The actual URL of the API will depend on your company domain, and will be handled by the package automatically once you setup the config file. The API documentation can be found here < https://documentation.bamboohr.com/docs>.

bambooHR

{bambooHR} is an R wrapper for the bambooHR API. By supplying a company domain and an API access token, users can seamlessly make API requests through built-in R functions. Get employees, employee files, reports and tables, all from within R.

Installing and Loading {bambooHR}

To install the latest release from CRAN, run:

install.packages("bambooHR")

Alternatively to install latest version on GitHub, run:

remotes::install_github("https://github.com/MangoTheCat/bambooHR")

Finally, load the package:

library(bambooHR)

Authentication

In order to obtain an API key, you will need to login to bambooHR via an account with administrative privileges. Hit the user icon in the top-right and select ‘API Keys’. Next, enter a name for the API key in the API Key Name field and click Generate Key. Copy the key to clipboard.

Now run the config_setup() function, supplying your API key and the company domain, plus an optional filepath for where to store the config file.

config_setup(apikey = "API_KEY_12345", 
             companyname = "Ascent", 
             conffile = "./bbhr_config.json")

The package functions will now pull in your configuration information automatically.

get_employee()