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 http //www hibob com/ add a connection to hibob in engini enter your engini account at https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking https //app engini io/connections click on the new integration option located at the topbar choose “hibob” option from available applications enter the following details in the “add connection” form 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 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 set criteria that must be met before the workflow runs select from the drop down the field you want to add the condition on select the condition you want to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields 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 set criteria that must be met before the workflow runs select from the drop down the field you want to add the condition on select the condition you want to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields 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 set criteria that must be met before the workflow runs select from the drop down the field you want to add the condition on select the condition you want to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields 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 set criteria that must be met before the workflow runs select from the drop down the field you want to add the condition on select the condition you want to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields 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 set criteria that must be met before the workflow runs select from the drop down the field you want to add the condition on select the condition you want to meet click on the empty field and the tooltip will pop up showing the options you can choose you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields 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 filters – the “add filters” button allows you to select the specific fields you want to retrieve you can also choose the data’s format, which converts the “machine format” numeric ids into human readable values that are easier to understand by clicking the “add filters” button, you can choose how to fill in the various fields choose from the drop down the field you want to fill click on the empty field to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using functions and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields 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 filters – clicking “add filters” lets you choose which parameters to use, such as employee id choose from the drop down the field you want to fill click on the empty field to be shown the tooltip with all the options you can use to fill the field you can populate the field in one of the following options static value – number / string when using strings, you need to surround them with single quotes (‘) property value from a previous activity (using the tooltip that opens when clicking on the field) expression – using https //app archbee com/public/preview ixqqblwfxopjg0nave78y/preview o3kkbgi5xnqf yvnuqkcv#ca 5p and/or previous activity properties and/or static values (using the tooltip that opens when clicking on the field) repeat steps 1 3 for all the fields 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