Request signatures
Send an e-signature template to one or more employees.
POST https://cotlet.dev/api/v1/bamboohr/templates/{template_id}/signature/request
write Confirm
Requests a signature on the template from each employee in one call. Employees are notified and sign from their BambooHR inbox; the signed copy goes to the folder set in the template. An employee who already has a pending request for the same template is skipped and reported. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| template_id string required | string | Template ID from list_signature_templates. |
| employee_ids string[] required | string[] | Employee IDs from find_employee. |
Request
curl -X POST https://cotlet.dev/api/v1/bamboohr/templates/sg_handbook_2026/signature/request \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"employee_ids":["412","418","431"]}'result = client.call("bamboohr", "request_signature", {"template_id":"sg_handbook_2026","employee_ids":["412","418","431"]})const result = await cotlet.call('bamboohr', 'request_signature', {"template_id":"sg_handbook_2026","employee_ids":["412","418","431"]});cotlet call bamboohr request_signature --data '{"template_id":"sg_handbook_2026","employee_ids":["412","418","431"]}'Example response
{
"template_id": "sg_handbook_2026",
"requested": [
{
"request_id": "sr_7710",
"employee_id": "412",
"employee": "Ana Kowal"
},
{
"request_id": "sr_7711",
"employee_id": "418",
"employee": "Tom Becker"
},
{
"request_id": "sr_7712",
"employee_id": "431",
"employee": "Lena Ortiz"
}
],
"requested_total": 3,
"skipped_pending": 0
}