Skip to content

Create Items

Endpoint

http
POST /unified/accounting/items
Integrations supported
  • QuickBooks
  • Xero

Query parameters

integrated_account_id
string · uuid
REQUIRED · The ID of the integrated account to use for the request.
Example: 62f44730-dd91-461e-bd6a-aedd9e0ad79d

Request Body

Refer Writing data using Unified APIs

id
string
REQUIRED · The unique identifier for the item
Required in
  • Xero
name
string
The name of the item
Supported in
  • Xero
description
string
The description of the item
Supported in
  • Xero
unit_price
number
The unit price of the item
Supported in
  • Xero
purchase_price
number
The purchase price of the item
Supported in
  • Xero
sales_account
string
The ID of the account used to record the sale
Supported in
  • Xero
purchase_account
string
The ID of the account used to record the purchase of the item
Supported in
  • Xero
remote_data
object
Any additional data that should be passed as part of the request body. This data is not transformed by Truto and is passed as is to the remote API.

Response Body

id
string
REQUIRED · The unique identifier for the item
Supported in
  • QuickBooks
  • Xero
name
string
The name of the item
Supported in
  • QuickBooks
  • Xero
description
string
The description of the item
Supported in
  • QuickBooks
  • Xero
status
string
The status of the item. If no clear mapping exists, then raw value is returned
All possible enum values:
  • active
  • archived
Supported in
  • QuickBooks
quantity
number
The quantity of the Item.
Supported in
  • QuickBooks
unit_price
number
The unit price of the item
Supported in
  • QuickBooks
  • Xero
purchase_price
number
The purchase price of the item
Supported in
  • QuickBooks
  • Xero
purchase_account
string
The ID of the account used to record the purchase of the item
Supported in
  • QuickBooks
  • Xero
sales_account
string
The ID of the account used to record the sale
Supported in
  • QuickBooks
  • Xero
asset_account
string
The ID of the account used to record the asset
Supported in
  • QuickBooks
company
string
The ID of the company the item belongs to
created_at
string
This represents the date when the item was created
Supported in
  • QuickBooks
updated_at
string
This represents the date when the item was updated
Supported in
  • QuickBooks
  • Xero
remote_data
object
Raw data returned from the remote API call.