Manage recurring reimbursements
Use the Recurring Reimbursements API to manage recurring reimbursements (such as a monthly phone stipend) for employees. Once a recurring reimbursement is created, it will automatically appear when a payroll is prepared for the employee, according to its frequency.
Create recurring reimbursements
Use the POST /employees/{employee_uuid}/recurring_reimbursements endpoint to add a recurring reimbursement (such as a monthly phone stipend) to an employee. The description is the humanβreadable label shown in payroll and reports.
Sample request
curl --request POST \
--url https://api.gusto-demo.com/v1/employees/employee_id/recurring_reimbursements \
--header 'X-Gusto-API-Version: 2024-04-01' \
--header 'accept: application/json' \
--header 'content-type: application/json'
Sample response
{
"uuid": "dd2c6317-f599-4f5b-a9a3-07eb67f7f2a9",
"employee_uuid": "7b079bfd-a244-485e-a49c-2ac841c5abb2",
"version": "e52d91b070d20cf3e682aa16086f5b90",
"description": "Travel reimbursement",
"created_at": "2025-10-22T15:07:01.000-07:00",
"updated_at": "2025-10-22T15:07:01.000-07:00",
"amount": "250.75"
}
Prepare payroll to view reimbursements
Newly created recurring reimbursements won't populate on a payroll until that payroll has been prepared.
Prepare the payroll to see new recurring reimbursements.
Managing recurring reimbursements
| Action | Endpoint | Note |
|---|---|---|
| Update | PUT /v1/recurring_reimbursements/{id} | Recurring reimbursements cannot be edited via PUT /v1/companies/{company_id}/payrolls/{payroll_id} once created. They must be edited via PUT /v1/recurring_reimbursements/{id}. |
| Get | GET /v1/recurring_reimbursements/{id} | |
| Delete | DELETE /v1/recurring_reimbursements/{id} |
Updated 8 days ago