Asset

Represents an item of commercial value owned by an Account or Contact, for example, a product previously sold and installed.

Supported Calls

create(), update(), delete(), query(), search(), retrieve(), getDeleted(), getUpdated(), describeLayout(), describeSObjects(), upsert()

Fields

Field	Field Type	Field Properties	Description
AccountId	reference	Create Filter Nillable Update	Required. ID of the Account associated with this asset. Must be a valid account ID. Required if ContactId is not specified. For information on IDs, seeID Field Type.
ContactId	reference	Create Filter Nillable Update	Required if AccountId is not specified. ID of the Contact associated with this asset. Must be a valid contact ID that has an account parent (but does not need to match the asset’s AccountId).
Description	string	Create Nillable Update	Description of this asset.
InstallDate	date	Create Filter Nillable Update	Date on which this asset was installed.
IsCompetitorProduct	boolean	Create Defaulted on create Filter Update	Indicates whether this Asset represents a product sold by a competitor (`true`) or not (`false`). Default value is `false`. Label is Competitor Asset.
IsDelete	boolean	Defaulted on create Filter	Indicates whether the object has been moved to the Recycle Bin (`true`) or not (`false`). Label is Deleted.
Name	string	Create Filter idLookup Update	Required. Name of the asset. Label is Asset Name.
Price	double	Create Filter Nillable Update	Price paid for this asset.
Product2Id	reference	Create Filter Nillable Update	ID of the Product2 associated with this asset. Must be a valid Product2 ID. Optional.
PurchaseDate	date	Create Filter Nillable Update	Date on which this asset was purchased.
Quantity	double	Create Filter Nillable Update	Quantity purchased or installed.
SerialNumber	string	Create Filter Nillable Update	Serial number for this asset.
Status	picklist	Create Filter Nillable Update	Customizable picklist of values. The default picklist includes the following values: Purchased Shipped Installed Registered Obsolete
UsageEndDate	date	Create Filter Nillable Update	Date when usage for this asset ends or expires.

Usage

Use this object to track assets previously sold into customer accounts. With asset tracking, a client application can quickly determine which products were previously sold or are currently installed at a specific account.

For example, your organization might want to renew and up-sell opportunities on products sold in the past. Similarly, your organization might want to track competitive products that exist in a customer environment that could potentially be replaced or swapped out.

Asset tracking is also useful for product support, providing detailed information to assist with product-specific support issues. For example, the PurchaseDate or SerialNumber could indicate whether a given product has certain maintenance requirements, including product recalls. Similarly, the UsageEndDate might indicate when the asset was removed from service or when a license or warranty expires.

If an application creates a new Asset record, it must at least specify a Name and either an AccountId, ContactId, or both.