# BambooHR

API configuration: `bamboohr`, `bamboohr-basic`

### Features

| Features                                                                                                                      | Status                        |
| ----------------------------------------------------------------------------------------------------------------------------- | ----------------------------- |
| [Auth (Basic)](https://github.com/shahab-bahojb-basketAsia/terapi-docs/blob/main/integrate/guides/authorize-an-api/README.md) | ✅                             |
| [Sync data](https://terapi.gitbook.io/terapi-api-explorer/integrate/guides/sync-data-from-an-api)                             | ✅                             |
| [Perform workflows](https://terapi.gitbook.io/terapi-api-explorer/integrate/guides/perform-workflows-with-an-api)             | ✅                             |
| [Proxy requests](https://terapi.gitbook.io/terapi-api-explorer/integrate/guides/proxy-requests-to-an-api)                     | ✅                             |
| [Receive webhooks](https://terapi.gitbook.io/terapi-api-explorer/integrate/guides/receive-webhooks-from-an-api)               | 🚫 (time to contribute: <48h) |

We can implement missing features in <48h, just ask for it in the community.

### Getting started

* [Web API docs (their REST API)](https://documentation.bamboohr.com/docs/getting-started)
* [How to register/integrate an Application](https://documentation.bamboohr.com/docs#what-will-you-need-to-get-started)
* [OAuth-related docs](https://documentation.bamboohr.com/page/single-sign-on-sso-with-openid-connect)
* [Web API docs (their REST API)](https://documentation.bamboohr.com/reference/get-employee)

Do you need help? Please check this link.

### Connection configuration in Terapi

BambooHR requires a user-specific subdomain to authenticate.

You should request this from the user and pass it to Terapi in the `terapi.auth()` call:

```js
// oAuth
terapi.auth('bamboohr', '', });
// API key
terapi.auth('bamboohr-basic', '', ,
        params: 
    })
```

Add Connection configuration in Terapi by editing this page.