Create an expense for the authenticated employee

Creates a new expense record for the current employee.

Scopes

CategoryRead only ScopeWrite only Scope (read access implicit)
Manage expenses (employment_payments)-Manage expenses (expense:write)
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Expense params

Params for creating an expense as the authenticated employee.

The employment is implied by the access token, so employment_id is not accepted.
reviewer_id and reviewed_at are also omitted — they only apply to manager-created expenses.

Category selection mirrors the company endpoint: use either category (legacy enum, deprecated but supported)
or expense_category_slug (recommended). When both are provided, expense_category_slug wins.

integer
required

The expense amount in the specified currency, in cents.

string | null
enum
deprecated

Categories allowed for an expense (legacy, deprecated).

Note: coworking, home_office, phone_utilities, travel are deprecated and will be removed in the future.

string
required

The three-letter code for the expense currency.

Examples: "USD", "EUR", "CAD"

string | null

Slug of the expense category from the hierarchical categories system (recommended). Takes precedence over legacy category field.

string
required

Date of the purchase, which must be in the past

receipt
object

All the params needed upload a base64 file.

receipts
array of objects
length ≤ 5
receipts
integer

The tax portion of the expense amount, in cents. Use 0 if no tax applies.

string
string
required

A short description of the expense (e.g., "New keyboard", "Team dinner").

Responses

Callback
Language
Credentials
OAuth2
URL
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json