Add task lists to an employee
Import onboarding or offboarding task lists to an employee, as Add Task List(s) and Save Tasks do.
POST https://cotlet.dev/api/v1/bamboohr/employees/{employee_id}/task-lists
write Confirm
Imports the chosen lists to the employee's Onboarding or Offboarding tab. By default only tasks whose filters include the employee are imported, the same as BambooHR's preselection, and the response says how many were filtered out. Assignees can be notified, on the timing set for each task. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| employee_id string required | string | Employee ID from find_employee. |
| kind string required | string | Which checklist: 'onboarding' or 'offboarding'. |
| list_ids string[] required | string[] | Task list IDs from list_task_lists. |
| include_unmatched boolean | boolean | true also imports tasks whose filters do not include the employee. Default: false. |
Request
curl -X POST https://cotlet.dev/api/v1/bamboohr/employees/412/task-lists \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"kind":"onboarding","list_ids":["tl_it_setup","tl_manager"]}'result = client.call("bamboohr", "add_task_lists", {"employee_id":"412","kind":"onboarding","list_ids":["tl_it_setup","tl_manager"]})const result = await cotlet.call('bamboohr', 'add_task_lists', {"employee_id":"412","kind":"onboarding","list_ids":["tl_it_setup","tl_manager"]});cotlet call bamboohr add_task_lists --data '{"employee_id":"412","kind":"onboarding","list_ids":["tl_it_setup","tl_manager"]}'Example response
{
"employee_id": "412",
"kind": "onboarding",
"lists_added": [
{
"list_id": "tl_it_setup",
"name": "IT setup",
"tasks_added": 4
},
{
"list_id": "tl_manager",
"name": "Manager tasks",
"tasks_added": 3
}
],
"tasks_added_total": 7,
"tasks_filtered_out": 0
}