Creates a new expense entry. Requires at minimum an expense date, amount, and expense category (by ID or name).

The date of the expense entry (Required)

UserID for a Timesheet/Expense user in Avaza. If not provided, UserEmail field must be provided

The email address of a Timesheet/Expense user in Avaza. If not provided, UserIDFK field must be provided.

The expense category to link the Expense to. If not provided, ExpenseCategoryName must be provided

Must match an existing expense category name otherwise a new category will be created. If left blank Expense Category ID must be provided.

aka Billable. Defaults to false if not provided. If set to true, a CustomerIDFK or CustomerName must be provided.

Defaults to false if not provided.

Conditional - available for expenses that are assigned a unit priced based expense category. e.g Mileage

The Avaza Customer ID to associate the Expense with. Either this field or CustomerName can be provided.

The name of an existing customer in Avaza. Must be an exact (case insensitive) match.

The Avaza project ID to associate the Expense with.

Can work for matching an expense to a project, but only if it's an exact match for a single project under the customer.

(optional) TaskID of a Task to link the new Expense to. A Customer and Project must be provided also.

A 3-letter ISO CurrencyCode for the expense currency. (e.g. USD). If not provided, defaults to the Account base currency.

Optional (Only relevant if the expense currency is different to your account currency. If not provided we will look up the market exchange rate for you based on the expense date.) Exchange Rate = Expense Currency Amount / Base Currency Amount (e.g. if Expense currency is in AUD, and Base Currency is in USD, Exchange Rate = AUD $140 / USD $100 = 1.4)

Expense Amount (Required). Must be >= 0

Avaza Tax ID the expense belongs to. If left blank then Tax Name must be provided.

Must exactly match an existing Tax Name that you have configured in Avaza Tax settings. If left blank then Tax ID must be provided.

Optional - Enter "INC" if the tax amount is included in the expense amount otherwise enter "EX" when the amount exlcudes the tax. Defaults to "Ex". The tax amount on the expense will be autocalculated.

Links the expense to a Grouping/Trip report. If no matching name found, creates a new Group/Trip Report name.

(Optional) ID of Expense Payment Method.

The name of the merchant.

A Tax number identifier for the merchant.

Expense Notes

Pass false if creating a draft expense. True otherwise.

If true, fires the expense_created webhook event to any subscribed endpoints. Defaults to false to preserve existing integration behaviour.

Unique identifier for the expense entry.

The user ID who created/owns this expense.

First name of the expense user.

Last name of the expense user.

Email address of the expense user.

The customer/company ID the expense is associated with.

Name of the associated customer/company.

The project ID the expense is linked to.

Title of the associated project.

Short code of the associated project.

The task ID the expense is linked to.

Title of the associated task.

The expense category ID.

Name of the expense category.

Whether the expense category has a predefined unit price (e.g. mileage rate).

The unit price for the expense category, if applicable.

The unit label (e.g. 'miles', 'km') for unit-priced categories.

ISO 3-character currency code for the expense.

Exchange rate from expense currency to account base currency.

Quantity for unit-priced expenses (e.g. number of miles).

The expense amount in the expense currency.

Calculated tax amount on the expense.

The tax rate ID applied to this expense.

Name of the applied tax rate.

Tax configuration: 'EX' (exclusive) or 'INC' (inclusive).

Display name for the tax configuration.

Whether the exchange rate is from an official/market source.

Approval status. Values: Draft, Pending, Approved, AutoApproved, Rejected, Verified.

The payment method ID used for this expense.

Name of the payment method.

Whether the expense is billable to the customer.

Detailed chargeable status code.

Whether the expense is reimbursable to the employee.

Reimbursement processing status.

The reimbursement batch ID this expense belongs to, if reimbursed.

The date the expense was incurred.

ID of the receipt/file attachment, if any.

Public URL of the expense receipt attachment.

URL for a preview/thumbnail of the expense attachment.

Name of the merchant/vendor.

Tax registration number of the merchant.

Additional notes on the expense.

ID of the expense report/group this expense belongs to.

Name of the expense report/group.

Date and time the expense record was created.

Date and time the expense record was last updated.

Url to view the Expense in Avaza