Expenses
Create Hris Expense
Adds a line item to a draft/rejected/info-requested report, resolving FX rate and recalculating totals.
Not available to API keys yet. It will need expenses:write.
curl --request POST \
--url 'https://api.toku.com/hris/create-hris-expense' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
"roleInOrgID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"hrisExpenseReportID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"merchant": "string",
"description": "string",
"hrisExpenseCategoryID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"expensedDate": "2026-01-01T00:00:00Z",
"amountSpent": "string",
"currencySpentID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"amountInExpenseCurrency": "string",
"expensedCurrencyID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"exchangeRateFromCurrencySpentToExpense": "string",
"spentAmount": "string",
"spentCurrencyID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"reimbursableAmount": "string",
"reimbursementCurrencyID": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fxRate": "string",
"isReimbursable": true,
"fileIDs": [
"3fa85f64-5717-4562-b3fc-2c963f66afa6"
]
}'{
"hrisExpenseID": "string"
}Authorizations
AuthorizationstringheaderrequiredBearer authentication header of the form Bearer <token>, where <token> is an access token from a Toku sign-in. See Authentication in the API reference.
Body
application/json
roleInOrgIDstring<uuid>hrisExpenseReportIDstring<uuid>merchantstringrequiredAllowed: 1 to 100 characters
descriptionstringNOTE(ck): a .transform() rule is not mirrored here; TGA still enforces it
hrisExpenseCategoryIDstring<uuid>expensedDatestring<date-time>requiredamountSpentstring | any | numberNOTE(ck): z.instanceof(Decimal) has no contract form; TGA still checks it
currencySpentIDstring<uuid>amountInExpenseCurrencystring | any | numberNOTE(ck): z.instanceof(Decimal) has no contract form; TGA still checks it
expensedCurrencyIDstring<uuid>exchangeRateFromCurrencySpentToExpensestring | any | numberNOTE(ck): z.instanceof(Decimal) has no contract form; TGA still checks it
spentAmountstring | any | numberNOTE(ck): z.instanceof(Decimal) has no contract form; TGA still checks it
spentCurrencyIDstring<uuid>reimbursableAmountstring | any | numberNOTE(ck): z.instanceof(Decimal) has no contract form; TGA still checks it
reimbursementCurrencyIDstring<uuid>fxRatestring | any | numberNOTE(ck): z.instanceof(Decimal) has no contract form; TGA still checks it
isReimbursablebooleanfileIDsstring<uuid>[]Allowed: at most 20 items
Response
200Successful response
hrisExpenseIDstringrequired