HiBob

learn how to connect engini to hibob using engini’s hibob activities, you can get all open tasks, the list of employees’ employment history, a list of work history for a list of employees, company employee fields, and mark a task as complete to get started, create an account on hibob http //www hibob com/ add a connection to hibob in engini enter your engini account at https //app engini io https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking here https //app engini io/connections click on the "new integration" option located at the top bar choose “hibob” option from available applications enter the following details in the “new integration” form and press save connection name – a unique identifier for the connection within engini user id – this is the unique id for the service user you create in your hibob account for api access token – enter the secret authentication token associated with the user id save after signing in, click on the save button to save the connection triggers webhooks employee this trigger starts a workflow when a specific employee event occurs in hibob url – this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your hibob webhook configuration type use the type field to select the employee event you want to listen for (e g employee created) add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions webhooks docs this trigger starts a workflow when a specific docs event occurs in hibob url – this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your hibob webhook configuration type use the type field to select the docs event you want to listen for (e g esign document signing complete) add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions webhooks task this trigger starts a workflow when a specific task event occurs in hibob url – this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your hibob webhook configuration type use the type field to select the docs event you want to listen for (e g task status changed) add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions webhooks time off this trigger starts a workflow when a specific time off event occurs in hibob url – this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your hibob webhook configuration type use the type field to select the docs event you want to listen for (e g time off request approved) add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions webhooks workforce planning this trigger starts a workflow when a specific workforce planning event occurs in hibob url – this is an automatic webhook url generated by engini this url cannot be edited or modified use the copy icon on the right to copy the url and paste it into your hibob webhook configuration type use the type field to select the docs event you want to listen for (e g position updated) add conditions click add conditions to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add conditions activities mark a task as complete this activity updates a task in hibob, marking it as complete by using its unique task id task id – enter the unique id of the task that you want to mark as complete read all open tasks this activity gets a list of all tasks that are currently active or incomplete within the hibob system read company employee fields by employee id this activity retrieves specific data fields for a single employee using their backend id identifier – provide the employee’s unique backend id to access their company fields add filter click add filter to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add filters list work history for a list of employees this activity retrieves the work history for multiple employees at once, by providing a list of their ids add filter click add filter to define conditions that narrow down the data list and return only the relevant items to learn more about using filters, click here https //help engini ai/workflow editor#add filters list employees employment history this activity fetches the full employment history for a specific employee id – enter the employee’s id to retrieve their employment history send api request this activity allows you to send a custom api request directly to hibob’s api base url – this is the root url of the api you’re sending the request to relative url – you can specify additional path segments or parameters that need to be added to the end of the automatically generated url this allows you to customize the specific request you want to perform method – select the http method (e g , get, post, put, delete, patch) body type – defines the format of the data in the body of your request commonly used values include application/json (as shown), which means the body will contain a json formatted payload body – contains any data that is being sent to the server add headers – additional metadata about the request, such as the type of data the engini can accept, the length of the request body, and authentication information click on the “add headers” button to add a header click on the headers field to enter the key, and on the value field to enter a value each header consists of a key value pair, where the key is the name of the parameter, and the value is the data associated with that parameter click on the “add” button to add more headers add queries – the query refers to the parameters or data that are included in the url of an http request to provide additional information or instructions to the server click on the “add queries” button to add a query click on the queries field to enter the key, and on the value field to enter a value each query consists of a key value pair, where the key is the name of the parameter, and the value is the data associated with that parameter click on the “add” button to add more queries