Documentation
    {{docApp.userSession.userId}}
    {{docApp.userSession.userName}}
    {{docApp.userSession.email}}
    Issuer : {{docApp.userSession.issuerInstance}}
    Expires : {{new Date(docApp.userSession.validUntil).toLocaleDateString()}}

{{docApp.title}}

{{docApp.description}}

How can we help?

{{docApp.searchError}}
{{product.name}}

Searching in {{docApp.searchFilterBySpecificBookTitle}}

{{docApp.searchResultFilteredItems.length}} results for: {{docApp.currentResultsSearchText}} in {{docApp.searchFilterBySpecificBookTitle}}
Search results have been limited. There are a total of {{docApp.searchResponse.totalResultsAvailable}} matches.

You have an odd number of " characters in your search terms - each one needs closing with a matching " character!

{{docApp.libraryHomeViewProduct.title || docApp.libraryHomeViewProduct.id}}

{{docApp.libraryHomeViewProduct.description}}

  1. {{book.title}}

{{group.title || group.id}}

{{group.description}}

  1. {{book.title}}

{{group.title}}

{{book.title}}
More...

Employees / Add

  • Article
  • 3 minutes to read

Operation Information

Creates a new Employee in BambooHR.

This is a Premium Integration.

Authentication

This operation requires authentication, the details of which can be securely stored on your instance in a KeySafe Key of type API Key.

To create a key of this type:

  • In the Configuration area of your Hornbill instance, navigate to Platform Configuration > Security > KeySafe;
  • Click on the + Create New Key button;
  • On the resulting Create New Key form, choose API Key in the Type pick list;
  • Give the API Key KeySafe key a Title (this is the name / identifier for the API Key account as you will see it when using the cloud automation node in your workflows);
  • Optionally populate the Description field;
  • Populate the following fields accordingly, then click the Create Key button to create your new key:
Name Type Description
ApiKey string Authentication Key
API Endpoint string Optional API Endpoint

Tip

The API Key field should be populated with an API Key that is generated against the BambooHR account that you wish to perform the actions as. See the BambooHR documentation for information about generating keys.

The API Endpoint field should be populated with the subdomain used to access your BambooHR account, as so: https://[API Endpoint].bamboohr.com.

Revoking Access

If at any point you wish to revoke access to any of the above accounts from your Hornbill instance, just delete the relevant KeySafe key(s) from the KeySafe list.

Warning

This will revoke the rights of any existing Cloud Automation Node in your Hornbill Workflows that are using the revoked API Key account, so you will need to manage these workflows accordingly.

Input Parameters

Display Name ID Type Description Required Supported Values
First Name firstName string None provided Yes None provided
Middle Name middleName string None provided No None provided
Last Name lastName string None provided Yes None provided
Preferred Name preferredName string None provided No None provided
Gender gender string None provided No None provided
Job Title jobTitle string None provided No None provided
Work Phone workPhone string None provided No None provided
Mobile Phone mobilePhone string None provided No None provided
Work Email workEmail string None provided No None provided
Department department string None provided No None provided
Location location string None provided No None provided
Division division string None provided No None provided
Work Phone Extension workPhoneExtension string None provided No None provided
Can UploadPhoto canUploadPhoto boolean None provided No None provided
Date Of Birth dateOfBirth string None provided No None provided
Address Line 1 address1 string None provided No None provided
Address Line 2 address2 string None provided No None provided
City city string None provided No None provided
State/Province state string None provided No None provided
State/Province Code stateCode string None provided No None provided
Status status string None provided No None provided
Country country string None provided No None provided
Zip/Postal Code zipcode string None provided No None provided
Home Email homeEmail string None provided No None provided
Home Phone homePhone string None provided No None provided
Hire Date hireDate string None provided No None provided
Original Hire Date originalHireDate string None provided No None provided
Ethnicity ethnicity string None provided No None provided
Nationality nationality string None provided No None provided
National ID nationalId string None provided No None provided

Output Parameters

Display Name ID Type Description
Outcome outcome string The Outcome of the Cloud Automation Integration
Errors errors string Any errors returned from the Cloud Automation Integration
Employee ID id number The ID of the new Employee
  • Version {{docApp.book.version}}
  • Node {{docApp.node}} / {{docApp.build}}
In This Document