Skip to main content
GuidesAPI Reference

Create Item

POST 
/accounting/items

Create an Accounting Item.

Request​

Query Parameters

    credentialId stringrequired

    The ID of the credential.

Header Parameters

    Authorization stringrequired

    Default value: bearer YOUR_API_KEY

Body

    itemName stringrequired

    The unique name or label identifying the specific item.

    itemType stringrequired

    Classification of the item based on its nature or usage. Possible values: SERVICE, NON_INVENTORY, INVENTORY

    qtyOnHand int32

    The current quantity of the item available in stock or on-hand. Required if itemType is INVENTORY. Not allowed if itemType is SERVICE or NON_INVENTORY

    assetAccountId string

    The account ID reflecting the item's value if considered as an asset. Required if itemType is INVENTORY

    billAccountId stringrequired

    The account ID used for bills related to the item.

    itemStatus string

    The current condition or phase of the item. Possible values: ACTIVE, ARCHIVED

    unitPrice float

    The selling cost per individual unit of the item. Required if itemType is INVENTORY. Not allowed if itemType is SERVICE or NON_INVENTORY

    purchasePrice float

    The cost incurred to acquire or produce a single unit of the item.

    invoiceAccountId string

    The account ID used for invoices associated with the item.

    remoteFields json

    An object containing remote fields that are not supported by the common model. The keys are the names of the fields of the corresponding resource in the remote app, and the values can be strings, numbers, arrays or objects.

Responses​

200

Schema

    item

    object

    remoteId string
    itemName string
    itemStatus string
    itemType string
    unitPrice
    purchasePrice
    qtyOnHand
    billAccountId string
    invoiceAccountId
    assetAccountId
    companyId
    createdTimestamp integer

    Default value: 0

    updatedTimestamp integer

    Default value: 0

    id string
    remoteCreatedAt string
    remoteUpdatedAt string
    remoteDeleted boolean

    Default value: true

    createdAt string
    updatedAt string
Loading...