BongaWonga Reference

Useful tools and resources for working with the BongaWonga training APIs.

API Helper Script

The bw-api.sh script in the docs/howtos/examples/ directory lets you make authenticated requests to any BongaWonga API from the command line:

./docs/howtos/examples/bw-api.sh hris /employees
./docs/howtos/examples/bw-api.sh app /users 2 50
./docs/howtos/examples/bw-api.sh idp /groups

It requires the corresponding BW_*_API_KEY environment variable for each system.

System Endpoints

System

Base URL

Env Variable

BongaWonga App

https://app.bongawonga.com/api/v1

BW_APP_API_KEY

BongaWonga HRIS

https://hris.bongawonga.com/api/v1

BW_HRIS_API_KEY

BongaWonga IdP

https://idp.bongawonga.com/api/v1

BW_IDP_API_KEY

BongaWonga CustomApps

https://customapps.bongawonga.com/api/v1

BW_CUSTOMAPPS_API_KEY

All endpoints use Bearer token authentication (Authorization: Bearer <api-key>) and support ?page= and ?per_page= query parameters for pagination.

Getting API Keys

Sign in to each BongaWonga application, then navigate to your profile page:

System

Profile page

BongaWonga App

https://app.bongawonga.com/profile

BongaWonga HRIS

https://hris.bongawonga.com/profile

BongaWonga IdP

https://idp.bongawonga.com/profile

BongaWonga CustomApps

https://customapps.bongawonga.com/profile

External Resources