BambooHR n8n integrationAutomate BambooHR with n8n.

Runs a report already saved in BambooHR and returns it to the workflow as a file.

• Report ID: the report number. Hover the report name on the reports page in BambooHR and grab the ID from there.
• Format: CSV, JSON, PDF, XLS or XML. JSON keeps the rows usable by later nodes, PDF suits a report a human just opens.
• Put Output In Field: the name of the output field that carries the binary file data.
• Only Current (Options): hides future dated values from history table fields.

Writes a new employee record in BambooHR. The required list is long: the node expects a full personnel file.

• First Name and Last Name: the identity block, usually mapped from the previous node.
• Hire Date and Date of Birth: date values, not free text.
• Social Security Number: a standard United States Social Security number, with dashes (123-45-6789).
• Department Name or ID, Division Name or ID, Location Name or ID: pick from the list, or pass an ID by expression.
• Synced with Trax Payroll: whether the employee joins a pay schedule synced with Trax Payroll.

Reads one employee record and returns its fields to the workflow, so the rest of the run has something to work with.

• Employee ID: the BambooHR identifier of the person, not their name. It usually comes from an earlier node as {{ $json.id }}.
• Field Names or IDs (Options): the set of fields to pull back. Choose them from the list, or pass IDs through an expression. Asking for three fields instead of the whole file keeps the payload small and the workflow readable.

Returns the employee list, one item per person, which makes it the usual starting point for anything that loops over the whole company.

• Return All: switched on, n8n walks the API pages until every employee is in. Switched off, it stops at Limit.
• Limit: the maximum number of employees to return. Handy while you are still testing, because a run on the full directory is slower and noisier than a run on 5 people.

Changes an existing record. The node targets one person and rewrites the fields you pass, leaving the rest of the file alone.

• Employee ID: which record gets written. Get it wrong and you edit the wrong person, so map it from a lookup rather than typing it.
• Marital Status, Mobile Phone, Employee Number: part of the required block on every update.
• Pay Rate, Pay Per and Pay Type: the compensation block, with Pay Type covering salary, hourly, commission, contract and the rest.
• Update Fields: 20 optional fields, including Work Email, Work Phone, City and Country.

Removes one document from an employee file. There is no undo step in the workflow, so this one belongs behind a condition.

• Employee ID: the employee whose file holds the document.
• File ID: the identifier of the employee file to remove. Read it from a Get many employee documents step rather than hardcoding it.

Fetches the actual content of a document attached to an employee and puts it in the workflow as binary data, ready to attach, forward or store elsewhere.

• Employee ID: whose file the document sits in.
• File ID: which document to pull.
• Put Output In Field: the output field that will carry the binary file data. Downstream nodes read that field name, so keep it consistent across the workflow.

Lists what is filed under one employee, with an item per document. Nothing is downloaded here, only the index.

• Employee ID: the person whose documents get listed.
• Return All and Limit: on, every document comes back; off, the list stops at Limit.
• Simplify: returns a trimmed version of the response instead of the raw API payload, which is enough when you only need names and IDs.

Edits the metadata around a document already filed under an employee: what it is called, where it sits, who can see it. The content itself stays untouched.

• Employee ID and File ID: the document to edit.
• Employee Document Category Name or ID: the new category for the file, chosen from the list or passed as an ID through an expression.
• Name: the new name of the file.
• Share with Employee: whether the person can see it in their own view.

Sends a file from the workflow into one employee file, which is how documents reach BambooHR without a manual upload.

• Employee ID: the destination file.
• Employee Document Category ID: where the document lands inside that file.
• Input Data Field Name: the input field holding the binary file data. Supported file types are PNG and JPEG, which is worth checking before you wire a scanner or an email attachment into it.
• Share with Employee (Options): whether the upload is visible to the person.

Deletes a company file, meaning one of the shared documents that belongs to the organization rather than to a single employee.

• File ID: the identifier of the file to remove. Nothing else is asked, which is exactly why a wrong ID hurts here.

Brings a company file into the workflow as binary data. Same idea as the employee version, one level up: the document belongs to the company, not to a person.

• File ID: which company file to pull.
• Put Output In Field: the output field that receives the binary file data.

Lists the company files, no employee needed. Think of it as the index of the shared document library.

• Return All: on, n8n pages through the whole library; off, it stops at Limit.
• Limit: the ceiling on how many files come back.
• Simplify: a trimmed response instead of the raw payload, which is usually enough to match a name and grab an ID.

Reorganizes a company file without touching its content: new name, new category, different sharing.

• File ID: the company file being edited.
• Category Name or ID: moves the file to a different category, picked from the list or passed as an ID through an expression.
• Name: the new name of the file.
• Share with Employee: whether the file is shared.

Pushes a document into the company library, available to the organization instead of to one employee file.

• Input Data Field Name: the input field carrying the binary file data. Supported file types are PNG and JPEG.
• Category Name or ID: where the file lands, from the list or through an expression.
• Share with Employee (Options): whether people see it or only HR does.