Asset

adds a fixed asset

Changed on Oct 29, 2025

Adds an asset to the system

post/Assets

Request

Base URL
https://api.xero.com/assets.xro/1.0
URL
https://api.xero.com/assets.xro/1.0/Assets
Auth
OAuth 2
Authorization code: https://login.xero.com/identity/connect/authorize
Token URL: https://identity.xero.com/connect/token scopes: assets

Headers

Idempotency-Keystring

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

Request body

assetIdstring uuid

The Xero-generated Id for the asset

assetNamestring required

The name of the asset

assetTypeIdstring uuid

The Xero-generated Id for the asset type

assetNumberstring

Must be unique.

purchaseDatestring date

The date the asset was purchased YYYY-MM-DD

purchasePricenumber double

The purchase price of the asset

disposalDatestring date

The date the asset was disposed

disposalPricenumber double

The price the asset was disposed at

assetStatus'Draft' | 'Registered' | 'Disposed'

See Asset Status Codes.

warrantyExpiryDatestring

The date the asset’s warranty expires (if needed) YYYY-MM-DD

serialNumberstring

The asset's serial number

canRollbackboolean

Boolean to indicate whether depreciation can be rolled back for this asset individually. This is true if it doesn't have 'legacy' journal entries and if there is no lock period that would prevent this asset from rolling back.

accountingBookValuenumber double

The accounting value of the asset

isDeleteEnabledForDateboolean

Boolean to indicate whether delete is enabled

Example request

{
  "assetId": "3b5b3a38-5649-495f-87a1-14a4e5918634",
  "assetName": "Awesome Truck 3",
  "assetTypeId": "3b5b3a38-5649-495f-87a1-14a4e5918634",
  "assetNumber": "FA-0013",
  "purchaseDate": "2015-07-01T00:00:00",
  "disposalDate": "2020-07-01T00:00:00",
  "assetStatus": "Draft",
  "warrantyExpiryDate": "ca4c6b39-4f4f-43e8-98da-5e1f350a6694",
  "serialNumber": "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"
  },
  "bookDepreciationDetail": {
    "currentCapitalGain": 5.25,
    "currentGainLoss": 10.5,
    "depreciationStartDate": "2015-07-01T00:00:00",
    "costLimit": 9000,
    "residualValue": 10000,
    "priorAccumDepreciationAmount": 0.45,
    "currentAccumDepreciationAmount": 5
  },
  "canRollback": true,
  "isDeleteEnabledForDate": true
}

Response

return single object - create new asset