materials_update
Update SKU details like cost, price, and inventory status in ServiceTitan for accurate material management and job costing.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Material account | |
| active | No | Material active status | |
| addOnMemberPrice | No | Material add-on member price | |
| addOnPrice | No | Material add-on price | |
| assetAccount | No | Material asset account | |
| assets | No | ||
| bonus | No | Material bonus | |
| businessUnitId | No | Material business unit ID | |
| categories | No | ||
| chargeableByDefault | No | Material chargeable by default status | |
| code | No | Material code | |
| commissionBonus | No | Material commission bonus | |
| cost | No | Material cost | |
| costOfSaleAccount | No | Material cost of sale account | |
| costTypeId | No | Material cost type ID | |
| deductAsJobCost | No | Material deduct as job cost status | |
| description | No | Material description | |
| displayInAmount | No | Material display in amount status | |
| displayName | No | Material display name | |
| externalData | No | ||
| externalId | No | Material external ID | |
| generalLedgerAccountId | No | Material general ledger account ID | |
| hours | No | Material hours | |
| id | Yes | Format - int64. Unique id for the SKU is modified | |
| isConfigurableMaterial | No | Material is configurable material status | |
| isInventory | No | Material is inventory status | |
| isOtherDirectCost | No | Material is other direct cost status | |
| memberPrice | No | Material member price | |
| otherVendors | No | ||
| paysCommission | No | Material pays commission status | |
| price | No | Material price | |
| primaryVendor | No | ||
| source | No | Material source | |
| taxable | No | Material taxable status | |
| tenant | Yes | Format - int64. Tenant ID | |
| unitOfMeasure | No | Material unit of measure | |
| variationsOrConfigurableMaterials | No |
Input Schema (JSON Schema)
{
"$schema": "http://json-schema.org/draft-07/schema#",
"additionalProperties": false,
"properties": {
"account": {
"description": "Material account",
"type": "string"
},
"active": {
"description": "Material active status",
"type": "boolean"
},
"addOnMemberPrice": {
"description": "Material add-on member price",
"type": "number"
},
"addOnPrice": {
"description": "Material add-on price",
"type": "number"
},
"assetAccount": {
"description": "Material asset account",
"type": "string"
},
"assets": {
"items": {
"additionalProperties": false,
"properties": {
"alias": {
"type": "string"
},
"fileName": {
"type": "string"
},
"isDefault": {
"type": "boolean"
},
"type": {},
"url": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"bonus": {
"description": "Material bonus",
"type": "number"
},
"businessUnitId": {
"description": "Material business unit ID",
"type": "integer"
},
"categories": {
"items": {
"type": "integer"
},
"type": "array"
},
"chargeableByDefault": {
"description": "Material chargeable by default status",
"type": "boolean"
},
"code": {
"description": "Material code",
"type": "string"
},
"commissionBonus": {
"description": "Material commission bonus",
"type": "number"
},
"cost": {
"description": "Material cost",
"type": "number"
},
"costOfSaleAccount": {
"description": "Material cost of sale account",
"type": "string"
},
"costTypeId": {
"description": "Material cost type ID",
"type": "integer"
},
"deductAsJobCost": {
"description": "Material deduct as job cost status",
"type": "boolean"
},
"description": {
"description": "Material description",
"type": "string"
},
"displayInAmount": {
"description": "Material display in amount status",
"type": "boolean"
},
"displayName": {
"description": "Material display name",
"type": "string"
},
"externalData": {
"items": {
"additionalProperties": false,
"properties": {
"key": {
"type": "string"
},
"value": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"externalId": {
"description": "Material external ID",
"type": "string"
},
"generalLedgerAccountId": {
"description": "Material general ledger account ID",
"type": "integer"
},
"hours": {
"description": "Material hours",
"type": "number"
},
"id": {
"description": "Format - int64. Unique id for the SKU is modified",
"type": "integer"
},
"isConfigurableMaterial": {
"description": "Material is configurable material status",
"type": "boolean"
},
"isInventory": {
"description": "Material is inventory status",
"type": "boolean"
},
"isOtherDirectCost": {
"description": "Material is other direct cost status",
"type": "boolean"
},
"memberPrice": {
"description": "Material member price",
"type": "number"
},
"otherVendors": {
"items": {
"additionalProperties": false,
"properties": {
"active": {
"type": "boolean"
},
"cost": {
"type": "number"
},
"id": {
"type": "integer"
},
"memo": {
"type": "string"
},
"otherSubAccounts": {
"items": {
"additionalProperties": false,
"properties": {
"accountName": {
"type": "string"
},
"cost": {
"type": "number"
},
"id": {
"type": "integer"
}
},
"type": "object"
},
"type": "array"
},
"primarySubAccount": {
"additionalProperties": false,
"properties": {
"accountName": {
"type": "string"
},
"cost": {
"type": "number"
},
"id": {
"type": "integer"
}
},
"type": "object"
},
"vendorId": {
"type": "integer"
},
"vendorName": {
"type": "string"
},
"vendorPart": {
"type": "string"
}
},
"type": "object"
},
"type": "array"
},
"paysCommission": {
"description": "Material pays commission status",
"type": "boolean"
},
"price": {
"description": "Material price",
"type": "number"
},
"primaryVendor": {
"additionalProperties": false,
"properties": {
"active": {
"type": "boolean"
},
"cost": {
"type": "number"
},
"id": {
"type": "integer"
},
"memo": {
"type": "string"
},
"otherSubAccounts": {
"items": {
"additionalProperties": false,
"properties": {
"accountName": {
"type": "string"
},
"cost": {
"type": "number"
},
"id": {
"type": "integer"
}
},
"type": "object"
},
"type": "array"
},
"primarySubAccount": {
"additionalProperties": false,
"properties": {
"accountName": {
"type": "string"
},
"cost": {
"type": "number"
},
"id": {
"type": "integer"
}
},
"type": "object"
},
"vendorId": {
"type": "integer"
},
"vendorName": {
"type": "string"
},
"vendorPart": {
"type": "string"
}
},
"type": "object"
},
"source": {
"description": "Material source",
"type": "string"
},
"taxable": {
"description": "Material taxable status",
"type": "boolean"
},
"tenant": {
"description": "Format - int64. Tenant ID",
"type": "integer"
},
"unitOfMeasure": {
"description": "Material unit of measure",
"type": "string"
},
"variationsOrConfigurableMaterials": {
"items": {
"type": "integer"
},
"type": "array"
}
},
"required": [
"id",
"tenant"
],
"type": "object"
}