Skip to main content
POST
Create an expense

Authorizations

x-api-key
string
header
required

Sellfern public API key scoped to the authenticated organization. Do not use user JWTs for public integrations.

Headers

Idempotency-Key
string

Client-generated key to prevent duplicate expense creation.

Body

application/json
category
string
required
Example:

"Software"

amount
number
required
Example:

49.99

date
string<date>
required
Example:

"2026-06-01"

store_id
string | null

Store ID. Omit or set null for consolidated overhead expenses.

description
string | null
Example:

"Monthly design tool subscription"

currency
string

Alias for original_currency.

Example:

"USD"

original_currency
string
Example:

"USD"

base_amount
number | null

Optional payroll base amount.

bhxh_amount
number | null

Optional payroll insurance amount.

bhxh_rate
number | null

Optional payroll insurance rate.

bhxh_type
string | null

Optional payroll insurance type.

employee_name
string | null

Optional employee name for payroll expenses.

Response

Expense created successfully.

success
boolean
Example:

true

data
object
meta
object