Introist needs API token with right scopes to work with. Scopes are Full employee read and Employee fields read.
Check HiBob’s article on how to find the API Token:
How do I get started with Bob's API?
An Application Programming Interface (API) allows two distinct software systems to communicate with each other. Programmers use APIs to send data to, or request data from, external systems. They also enable one system to access and use the capabilities of another system without knowing how that system works or needing to integrate those capabilities into itself.
- Go to HiBob and generate API token with said scopes
- Go to Introist and open “Settings” → “Integrations”
- “Activate” HiBob integration
- Submit API token to Credentials.
Importing people from HiBob
Introist uses `Read all company employees` -endpoint to fetch people in your organisation. Using conditions determined by you Introist will filter in only people you want to import to Introist. Introist needs scope Full employee read to use this dataset.
You will have full control on what data Introist reads into from HiBob. Introist uses `Get all company fields` -endpoint to select correct fields based on your configurations. Your point of contact will help you build the configuration. Introist needs scope Employee fields read to use this dataset.
Syncing people from HiBob
Introist can also sync people data from HiBob after import. Sync uses the same endpoint as import to get data and updates only the fields you are providing through the configuration using HiBob ID as identifier.