Skip to content

HR Data Definition (BambooHR API Integration)

In this step, you will choose the type of report to generate, attributes to process and the polling interval for your BambooHR integration.

You can also apply custom filters on the report data.

Choose the report type

BambooHR Reports

Figure 1. BambooHR reports.

Full Load

If you have selected Full Load then a full report for all the selected attributes from the employee attributes will be generated. This report will be generated on the basis of type of polling interval selected.

BambooHR Full Load

Figure 2. BambooHR full load.

Delta Load

If you have selected “Delta Load" then whenever there is any update or change in any of the attributes, it will automatically pull the updated report within the selected interval of time.

BambooHR Delta Load

Figure 3. BambooHR delta load.

For polling, you can refer to BambooHR polling.

Periodic Full Sync

Periodic Full Sync lets you keep your HR data up-to-date by scheduling regular updates. You can choose to run these updates every day, week, two weeks, or four weeks. For example, if you pick '1 day,' your first update will start 24 hours after setup, with future updates happening daily. This lets you ensure your HR data stays fully synchronized as needed.

Initial one-time full sync

You can select the Initial one-time full sync checkbox if you want to receive an initial pull of the full report as soon as the flow is deployed.

BambooHR Initial Pull

Figure 4. BambooHR initial pull.

Select employee attributes you want to process

You can select the employee attributes defined in the BambooHR that you want to be processed by Hire2Retire. Hire2Retire pre-selects important attributes. Pre-selected attributes can be removed by you if you don't want them included in the report.

BambooHR Employee Attributes

Figure 5. BambooHR employee attributes.

And, if you have enabled 'Future Hire, Rehire and Termination' on Application page then following fields will appear such as Date Format and Time Zone.

Select Date Format

Select the date format of the HR attributes that are of date type. The default date format is YYYY-MM-DD.

Details of Date Format

Figure 6. Details of Date Format


Select Time Zone

Choose the time zone in which you want to process the scheduled hire, rehire and termination events.

Single time zone

All the scheduled hire, rehire and termination events will be executed in a selected time zone. The default time zone is America/New York.

Details of Single Time Zone

Figure 7. Details of single time zone


Multiple time zone

Here, scheduled onboarding and offboarding records will be executed in the time zone based on the condition defined by HR data. For eg. An organization can have multiple offices at different locations (time zones) for which they can select respective time zones according to their locations.

Details of Multiple Time Zone

Figure 8. Details of multiple time zone


Apply Selection Criteria

Hire2Retire enables you to process specific events and filter out the rest by defining filter criteria. On clicking the Apply Filter button, you will be able to set up conditions using employee attributes. Only employees whose attributes match the conditions will be processed. You can create complex filters using AND or OR conditions.

Event Filtering for BambooHR Data

Figure 9. Event filtering for BambooHR data in Future Hire, Rehire and Termaination.