---
title: "Create Expense"
method: POST
path: "/expenses"
tags: ["Expenses"]
---

# Create Expense

`POST /expenses`

## Request

- Base URL: `https://timelodge.com/api/v1`
- URL: `https://timelodge.com/api/v1/expenses`
- Auth: HTTP bearer

Requires `expenses:write` and a unique idempotency key.

## Headers

- `Idempotency-Key` string, required

## Request body

- ExpenseWrite
  - `project_id` integer, nullable, required
  - `category_id` integer, nullable, required
  - `expense_date` string, date, nullable, required
  - `notes` string, nullable
  - `amount` number, nullable, required
  - `currency` string, nullable, required
  - `conversion_rate` number, nullable
  - `tax_rate` number, nullable
  - `markup_rate` number, nullable
  - `reimbursable` boolean, nullable
  - `billable` boolean, nullable

## Response `201`

The resource was created.

- ExpenseResponse
  - `data` Expense, required
    - `id` integer, nullable
    - `user_id` integer, nullable
    - `project_id` integer, nullable
    - `category_id` integer, nullable
    - `expense_date` string, date, nullable
    - `notes` string, nullable
    - `currency` string, nullable
    - `amount_minor` integer, nullable
    - `tax_minor` integer, nullable
    - `markup_minor` integer, nullable
    - `total_minor` integer, nullable
    - `reimbursable` boolean, nullable
    - `billable` boolean, nullable
    - `status` string, nullable
    - `is_locked` boolean, nullable
    - `created_at` string, date-time, nullable
    - `updated_at` string, date-time, nullable
    - `version` string: Opaque representation version used for optimistic concurrency.

## Other responses

- `400`: Invalid request.
- `401`: Missing or invalid token.
- `403`: The token lacks the required scope.
- `409`: Idempotency conflict or request in progress.
- `422`: Validation failed.
- `429`: Rate limit exceeded.

---

[API](https://skmtc.dev/timelodge/apis/timelodge-api.md) · [All operations](https://skmtc.dev/timelodge/apis/timelodge-api/llms.txt) · [OpenAPI document](https://skmtc.dev/timelodge/apis/timelodge-api/revisions/9072baafaa20?raw)