Skip to main content
POST
Create budget line item

Authorizations

Authorization
string
header
required

Use your API key as a Bearer token. API keys can be generated in Settings → Integrations → API Access.

Path Parameters

id
string<uuid>
required

Budget ID

Body

application/json
type
enum<string>
required

Item type (required)

Available options:
Software,
Hardware,
Labour,
Other,
Subscription
description
string
required

Item description (required)

Required string length: 1 - 1000
unitPrice
number
required

Unit price (required)

Required range: x >= 0
quantity
number

Quantity (default: 1)

Required range: x >= 0
recurrence
enum<string>

Recurrence (default: One-Time)

Available options:
One-Time,
Monthly,
Annual
termMonths
integer

Term in months (default: 1)

Required range: 1 <= x <= 120
status
enum<string>

Status (default: draft)

Available options:
pending,
approved,
rejected,
draft
currency
string

Currency code (default: USD)

Required string length: 3
notes
string

Item notes

Maximum string length: 5000
categoryId
string<uuid>

Category ID (from planner_item_types)

linkedItemId
string<uuid>

Linked item ID

linkedItemType
enum<string>

Linked item type

Available options:
device,
planner,
goal,
other

Response

Line item created successfully

data
object
required