productCreate Mutation

Creates a new product.

Input Argument

productCreate accepts a single input argument, an input type, which contains the values it uses.

The fields inside input are:

brand (String!)

The brand name is typically the name of the product's manufacturer.

category (String!)

The appropriate product category for the product.

clientMutationId (String)

A unique identifier for the client performing the mutation.

customFields ([CustomFieldInput!])

Values for custom fields to be used by the UI Extension that is linked to the record.

customFieldsAttachments ([AttachmentInput!])

The attachments used in the custom fields' values.

depreciationMethod (ProductDepreciationMethod)

Used to specify whether or not configuration items that are based on the product are typically depreciated and if so, which depreciation method is normally applied. Valid values are:

  • not_depreciated: Not Depreciated
  • double_declining_balance: Double Declining Balance
  • reducing_balance: Reducing Balance (or Diminishing Value)
  • straight_line: Straight Line (or Prime Cost)
  • sum_of_the_years_digits: Sum of the Year's Digits
disabled (Boolean)

Whether the product may no longer be used to register new configuration items.

financialOwnerId (ID)

Identifier of the internal organization which budget is normally used to obtain the product.

model (String)

The model of the product.

name (String!)

The name of the product. Fill out the Brand, Model, Product ID (optional) and Category fields to automatically generate a name based on the values entered in these fields.

pictureUri (String)

The hyperlink to the image file for the record.

productID (String)

The unique identifier of the product that is used by the manufacturer. The concatenation of brand and productID must be unique within a 4me account.

rate (Int)

The yearly rate that should normally be applied to calculate the depreciation of configuration items that are based on the product using the reducing balance (or diminishing value) method.

recurrence (RecurrenceInput)

Recurrence for maintenance of configuration items created from the product.

remarks (String)

Any additional information about the product that might prove useful.

salvageValue (MonetaryAmount)

The value of this configuration item at the end of its useful life (i.e. at the end of its depreciation period). When a value is not specified for this field, it is set to zero.

salvageValueCurrency (Currency)

The currency of the salvage value attributed to this configuration item.

serviceId (ID)

Identifier of the Service which Service Instances would typically include the product.

source (String)

An identifier for the client application submitting the resource or the name of an external system.

sourceID (String)

The unique identifier of the resource in an external system.

supplierId (ID)

Identifier of the organization from which the product is typically obtained. If the product is developed internally, select the internal organization that develops it. Note that a lease company should be selected in this field if the product is normally leased.

supportTeamId (ID)

Identifier of the team responsible for maintaining the product's information in the configuration management database (CMDB).

uiExtensionId (ID)

UI extension that is to be applied to the record.

usefulLife (Int)

The number of years within which configuration items that are based on the product are typically depreciated.

workflowManagerId (ID)

The person who will be responsible for coordinating the workflows that will be generated automatically in accordance with the recurrence schedule.

workflowTemplateId (ID)

The workflow template that is used to periodically maintain configuration items created from the product.

Return Fields

clientMutationId (String)

A unique identifier for the client performing the mutation.

errors ([ValidationError!])

Errors encountered during the mutation.

product (Product)

Record after mutation.