Find employee
Employees matching a name in the directory, with the employee ID the other tools need.
GET https://cotlet.dev/api/v1/bamboohr/employees/find
read
Returns the employees whose name matches the query, with ID, job title, department and hire date. Fields your BambooHR account cannot see are left out, never filled in. Use employee_id from each item in the task, signature and time off tools. Returns up to 25 matches; refine the query for more.
Parameters
| Name | Type | Description |
|---|---|---|
| query string required | string | Part of the employee name. |
Request
curl "https://cotlet.dev/api/v1/bamboohr/employees/find?query=query" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("bamboohr", "find_employee", {"query":"query"})const result = await cotlet.call('bamboohr', 'find_employee', {"query":"query"});cotlet call bamboohr find_employee --data '{"query":"query"}'Example response
{
"employees": [
{
"employee_id": "412",
"name": "Ana Kowal",
"job_title": "Account Executive",
"department": "Sales",
"hire_date": "2026-10-19"
}
]
}