materials_update

materials_update

Update material details in ServiceTitan, including account information, pricing, status, and vendor data, to maintain accurate inventory and billing records.

Input Schema

Name	Required	Description
`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"
}

ServiceTitan MCP Server

Input Schema

Input Schema (JSON Schema)

Other Tools from ServiceTitan MCP Server

Related Tools