v51

latestOpenAPI 3.0.0MITraw.githubusercontent.com2026-07-2161237.1 KB
Asset

adds a fixed asset type

Adds an fixed asset type to the system

post/AssetTypes

Headers

Idempotency-Keystring

This allows you to safely retry requests without the risk of duplicate processing. 128 character max.

Request body

assetTypeIdstring uuid

Xero generated unique identifier for asset types

assetTypeNamestring required

The name of the asset type

fixedAssetAccountIdstring uuid

The asset account for fixed assets of this type

depreciationExpenseAccountIdstring uuid

The expense account for the depreciation of fixed assets of this type

accumulatedDepreciationAccountIdstring uuid

The account for accumulated depreciation of fixed assets of this type

locksinteger

All asset types that have accumulated depreciation for any assets that use them are deemed ‘locked’ and cannot be removed.

Example request

{
  "assetTypeId": "5da209c5-5e19-4a43-b925-71b776c49ced",
  "assetTypeName": "Computer Equipment",
  "fixedAssetAccountId": "24e260f1-bfc4-4766-ad7f-8a8ce01de879",
  "depreciationExpenseAccountId": "b23fc79b-d66b-44b0-a240-e138e086fcbc",
  "accumulatedDepreciationAccountId": "ca4c6b39-4f4f-43e8-98da-5e1f350a6694",
  "bookDepreciationSetting": {
    "depreciationMethod": "StraightLine",
    "averagingMethod": "ActualDays",
    "depreciationRate": 0.05,
    "effectiveLifeYears": 5,
    "depreciationCalculationMethod": "None",
    "depreciableObjectId": "68f17094-af97-4f1b-b36b-013b45b6ad3c",
    "depreciableObjectType": "Asset",
    "bookEffectiveDateOfChangeId": "68f17094-af97-4f1b-b36b-013b45b6ad3c"
  },
  "locks": 33
}

Response

results single object - created fixed type

assetTypeIdstring uuid

Xero generated unique identifier for asset types

assetTypeNamestring required

The name of the asset type

fixedAssetAccountIdstring uuid

The asset account for fixed assets of this type

depreciationExpenseAccountIdstring uuid

The expense account for the depreciation of fixed assets of this type

accumulatedDepreciationAccountIdstring uuid

The account for accumulated depreciation of fixed assets of this type

locksinteger

All asset types that have accumulated depreciation for any assets that use them are deemed ‘locked’ and cannot be removed.

Example response

{
  "assetTypeId": "5da209c5-5e19-4a43-b925-71b776c49ced",
  "assetTypeName": "Computer Equipment",
  "fixedAssetAccountId": "24e260f1-bfc4-4766-ad7f-8a8ce01de879",
  "depreciationExpenseAccountId": "b23fc79b-d66b-44b0-a240-e138e086fcbc",
  "accumulatedDepreciationAccountId": "ca4c6b39-4f4f-43e8-98da-5e1f350a6694",
  "bookDepreciationSetting": {
    "depreciationMethod": "StraightLine",
    "averagingMethod": "ActualDays",
    "depreciationRate": 0.05,
    "effectiveLifeYears": 5,
    "depreciationCalculationMethod": "None",
    "depreciableObjectId": "68f17094-af97-4f1b-b36b-013b45b6ad3c",
    "depreciableObjectType": "Asset",
    "bookEffectiveDateOfChangeId": "68f17094-af97-4f1b-b36b-013b45b6ad3c"
  },
  "locks": 33
}