Generate Asset

Create a lifecycle-managed asset.

Resource

1/asset-management/assets/actions/generate

Available version

50.0

Requires Chatter

HTTP methods

POST

Limits

Asset: 1 per call
Asset state period: 10 per call
Asset action: 1 per call
Asset action source: 10 per asset action

Request body for POST

JSON example

1{
2  "accountId": "001B000001KDI7BIAX",
3  "assetName": "MDM Subscription",
4  "productId": "01tB0000000q2FFIAY",
5  "currencyIsoCode": "USD",
6  "assetStatePeriods": [
7    {
8      "startDate": "2020-01-01T09:00:00+08:00",
9      "endDate": "2020-12-31T08:59:59+08:00",
10      "quantity": 10,
11      "mrr": 100,
12      "amount": 1200
13    }
14  ],
15  "assetAction": {
16    "category": "Initial Sale",
17    "actionDate": "2019-09-05T16:00:00+08:00",
18    "quantityChange": 10,
19    "mrrChange": 100,
20    "amount": 1200
21  },
22  "assetActionSources": [
23    {
24      "transactionDate": "2019-09-05T16:00:00+08:00",
25      "startDate": "2020-01-01T09:00:00+08:00",
26      "endDate": "2020-12-31T08:59:59+08:00",
27      "quantity": 10,
28      "productAmount": 1200,
29      "referenceEntityItem": "1WLB00000003geJOAQ"
30    }
31  ]
32}

Properties

Name	Type	Description	Required or Optional	Available Version
`accountId`	String	Asset’s parent account.	Required	50.0
`assetAction`	Asset Action Input	Asset action that creates the asset.	Required	50.0
`assetActionSources`	Asset Action Source Input[]	List of asset action sources.	Optional	50.0
`assetName`	String	Name of the new asset.	Required	50.0
`assetStatePeriods`	Asset State Period Input[]	List of asset state periods affected by the generate asset call.	Required	50.0
`currencyIsoCode`	String	Three-letter ISO 4217 currency code associated with the lifecycle-managed asset record.	Required	50.0
`productId`	String	ID of the parent product for the asset.	Required	50.0

Response body for POST

Asset Result Output

Connect REST API Developer Guide

Generate Asset

See Also