Skip to main content

BambooHR

CatalogScorecardsTeams

Summary

BambooHR is a popular HRIS solution that lets organizations define organizational membership. Cortex syncs with BambooHR to automatically sync team memberships. You can use BambooHR to understand key information such as:

  • Ownership
  • Team Membership
  • Orphaned Services and Resources

Setup

In order to connect Cortex to your BambooHR instance, you’ll need to create a BambooHR API Key, and add it under Settings → BambooHR.

The token is tied to your BambooHR workspace, which you can find in your url as workspace.bamboohr.com.

If you do not see the Settings page you're looking for in the sidebar, you likely don't have the proper permissions and need to contact your admin.

Report Configuration

Cortex uses the BambooHR integration to automatically sync team memberships. If you have a custom BambooHR Report that has the authoritative list of active employees, you can optionally tell Cortex to use that instead, under Settings → BambooHR.

You can find the Report ID in the URL, for example subdomain.bamboohr.comreports/custom/New+Hires/[Report ID].

Team field

Cortex stores team memberships from BambooHR. It uses the division field to denote team membership, followed by department if division is not specified.

If you have a custom Employee field used to denote team membership, you can add that under Settings → BambooHR.

Registration

Catalog Descriptor

Ownership of each catalog entity through BambooHR is defined through an owner of type group.

x-cortex-owners:
    - type: group
      name: My Bamboo HR Team
      provider: BAMBOO_HR
    description: This is a description for this owner # optional

The name should be exactly equal to the value in the Team field.