Create an Expense

post

https://api.getknit.dev/v1.0/expense.create

Creates a new expense submission with amount, category, and receipt details.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Supported Apps

Here are the list of apps that support this API.

App	App ID	Notes
Expensify	`expensify`	Use Category name in `category` field.
Rydoo	`rydoo`	`userId` is a required fields. `groupId` key needs to be passed in `metaData`. Use passthrough Request to get user groups.
Lucca Expense	`lucca-expense`	Provide integer `quantity` and `paymentMethodId` inside `metaData`. `paymentMethodId` can be `0` - User, `1` - CorporateCard, `3` - Cleemy Card.

Body Params

creationDate

date

required

Date of expense creation in the format "YYYY-MM-DD" (e.g., "2024-01-15")

currency

string

required

3 letter ISO currency code, in which the expense is raised (e.g., "USD", "GBP", "INR")

merchant

string

required

Name of merchant

amount

double

required

Expense amount (eg. "100.25")

category

string

required

Category can be fetched via GET /expense.categories API

string

required

isReimbursable

boolean

Indicates whether the amount is reimbursable

comment

string

comments or notes, if supported by origin system

isBillable

boolean

Indicates whether the amount is billable

tag

string

Expense tag, if supported by origin system

userId

string

Use List Users endpoint to get the userId.

metaData

string

JSON-formatted string containing set of key-value attributes to provide additional data

Responses

Language

Credentials

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json

Supported Apps

200200

400400