Create expense
Creates an expense in a workspace with merchant, date, amount, currency and category.
POST https://cotlet.dev/api/v1/expensify/expenses
write Confirm
Creates one expense in your account, not on a report yet. Category and tags must exist in the workspace (read them with get_workspace), and the expense can be marked reimbursable or billable. Returns the new expense ID; add a receipt with attach_receipt and put it on a report with add_expense_to_report. By default you confirm each call; you can switch that off for this tool.
Parameters
| Name | Type | Description |
|---|---|---|
| workspace string required | string | Workspace name or ID from list_workspaces, e.g. 'Acme Studio'. |
| amount number required | number | Amount as a decimal number, e.g. 42.50. |
| currency string required | string | Three-letter currency code, e.g. 'USD'. |
| merchant string required | string | Merchant name as on the receipt. |
| date date required | date | Date of the expense, YYYY-MM-DD. |
| category string | string | A category of the workspace, from get_workspace. |
| tags string[] | string[] | Tags of the workspace, from get_workspace. |
| description string | string | Short note shown on the expense. |
| reimbursable boolean | boolean | Default: true. |
| billable boolean | boolean | Default: false. |
Request
curl -X POST https://cotlet.dev/api/v1/expensify/expenses \
-H "Authorization: Bearer $COTLET_API_KEY" \
-H "Content-Type: application/json" \
-d '{"workspace":"Acme Studio","amount":42.5,"currency":"USD","merchant":"Blue Bottle Coffee","date":"2026-10-12","category":"Meals","description":"Coffee with client before the Northwind kickoff"}'result = client.call("expensify", "create_expense", {"workspace":"Acme Studio","amount":42.5,"currency":"USD","merchant":"Blue Bottle Coffee","date":"2026-10-12","category":"Meals","description":"Coffee with client before the Northwind kickoff"})const result = await cotlet.call('expensify', 'create_expense', {"workspace":"Acme Studio","amount":42.5,"currency":"USD","merchant":"Blue Bottle Coffee","date":"2026-10-12","category":"Meals","description":"Coffee with client before the Northwind kickoff"});cotlet call expensify create_expense --data '{"workspace":"Acme Studio","amount":42.5,"currency":"USD","merchant":"Blue Bottle Coffee","date":"2026-10-12","category":"Meals","description":"Coffee with client before the Northwind kickoff"}'Example response
{
"expense_id": "T7f3a9c",
"workspace": "Acme Studio",
"merchant": "Blue Bottle Coffee",
"date": "2026-10-12",
"amount": 42.5,
"currency": "USD",
"category": "Meals",
"description": "Coffee with client before the Northwind kickoff",
"reimbursable": true,
"has_receipt": false,
"report_id": null,
"created_at": "2026-10-14T09:31:00+02:00"
}