Add Recurring and Itemized Reimbursements APIs

Added endpoints for managing recurring reimbursements (e.g., monthly phone stipend) for an employee’s payroll, and updated existing endpoints to manage itemized reimbursements in regular payrolls.

Read more about how to use these APIs in our guide on Manage recurring reimbursements, as well as our Complete a Regular Payroll guide.

Recurring reimbursements

The recurring reimbursement, once created:

• Can only be edited through the Recurring Reimbursements API
• Automatically appears when that employee’s payroll is prepared

Itemized reimbursements

In addition, reimbursements now appear as itemized reimbursements, so you can update specific items (for example, “Laptop charger,” or “Travel per diem”). Historically, these reimbursements were surfaced in a prepared payroll as a single total amount under fixed_compensations that you’d need to overwrite.

Endpoints

New

• GET /v1/employees/{employee_id}/recurring_reimbursements
• POST /v1/employees/{employee_id}/recurring_reimbursements
• GET /v1/recurring_reimbursements/{id}
• PUT /v1/recurring_reimbursements/{id}
• DELETE /v1/recurring_reimbursements/{id}

Updated

• PUT /v1/companies/{company_id}/payrolls/{payroll_id}/prepare
• PUT /v1/companies/{company_id}/payrolls/{payroll_id}