Prerequisites<\/strong><\/p>\n\n\n\n Considerations<\/strong><\/p>\n\n\n\n This option should not be used if the custom report returns more than 300<\/strong> rows.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n Per the Authentication<\/a> section of the BambooHR Getting Started with the API<\/a>, “the API key is sent over HTTP Basic Authentication. Use the secret key as the username and any random string for the password”.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n Copy the API Key to a secure location, like the 探花大神 Password Manager<\/a>, for future reference.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n If you want to manage the lifecycle and avoid creating inactive users, use this option, use the \/report endpoint, specifically the GET \/report\/<id><\/a> request.<\/p>\n\n\n\n You cannot use this option if more than 1200 rows return in the report as it will timeout. Use the \/directory<\/a> endpoint.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n A custom report with the attributes you want for the integration, including status, will need to be created in BambooHR. The id for the report is found in the URL shown when viewing the report in BambooHR. <\/p>\n\n\n\n To learn more about the 探花大神 Custom API integration connector, see Import Users with a Custom API Integration<\/a>.<\/p>\n\n\n\n If you only want this integration for populating manager<\/kbd>, the only optional mapping that will need to be included is the one for manager email. All others can be deleted.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n If your company always populates the preferred name<\/kbd> field in BambooHR, you can map that to First Name<\/kbd> in 探花大神. If it doesn\u2019t, then mapping firstname <\/kbd>will ensure that value is always populated in 探花大神. However, mapping to firstname <\/kbd>may result in users not having the first name they want. <\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n Do not click Save<\/strong> before clicking Activate<\/strong>. You will lose all of your configuration settings.<\/p>\n <\/div><\/div><\/div><\/div>\n\n\n\n A custom API integration can be used to import and update attributes that are not currently available to sync using […]<\/p>\n","protected":false},"author":205,"featured_media":0,"template":"","meta":{"_acf_changed":false,"_oasis_is_in_workflow":0,"_oasis_original":0,"_oasis_task_priority":"","inline_featured_image":false,"footnotes":""},"support_category":[2855,2954,3000,2900,2907],"support_tag":[],"coauthors":[2839],"acf":[],"yoast_head":"\n\n
\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/warning-icon.png\"){kind=icon}
<\/p><\/div>\n
Configuring the BambooHR API Authentication<\/strong><\/h2>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/note-icon.png\"){kind=icon}
<\/p><\/div>To generate the BambooHR API token<\/strong><\/h3>\n\n\n\n
\n
<\/p><\/div>To encode the BambooHR credentials<\/strong><\/h3>\n\n\n\n
\n
\n
base64 <<< 1208934bba29wa123492879873:x<\/kbd><\/li>\n\n\n\n\n
Configuring Custom Settings for \/report endpoint<\/strong><\/h2>\n\n\n\n
![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/important-icon.png\"){kind=icon}
<\/p><\/div>To configure BambooHR<\/strong><\/h3>\n\n\n\n
\n
\n
To configure 探花大神<\/strong><\/h3>\n\n\n\n
\n
\n
\n
![\"\"](\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/Snag_430c900d-781x1024.png\"){kind=spacer}
<\/figure>\n\n\n\n\n
\n
![\"\"](\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/Snag_447cee4c.png\")
<\/figure>\n\n\n\n<\/p><\/div>\n
\n
![\"\"](\"https:\/\/jumpcloud.com\/wp-content\/uploads\/2024\/07\/Snag_44744e69.png\")
<\/figure>\n\n\n\n![](\"\/wp-content\/themes\/jumpcloud\/assets\/images\/gutenberg-blocks\/tip-icon.png\"){kind=icon}
<\/p><\/div><\/p><\/div>\n
<\/p><\/div>\n
\n