Create / Update Contact Asset

Creating and updating an asset link from the API can be done by posting your asset link object to Supportbench.

The only difference between asset creations and updates is including an asset link id within the asset link object.

When creating or updating an asset, the below fields are available to you.

Name

Required

Limit

Default

Availability

Summary

id

no - when creating
yes - when updating

Integer

Update

This is the id of the linked asset. You can use this id to update an existing link to the contact. Leave this blank to create a new link.

contact_id

yes - when creating

30 characters

New / Update

The contact id that you would like to link the asset to.

asset_id

yes - when creating

30 characters

Update

The full asset id including the prefix.

support_level_id

no

integer

New / Update

The support level id that this asset will have.

active_from

no

DateTime

New / Update

The date the asset was or will be active on in UTC.

active_to

no

DateTime

New / Update

The date the asset was or will be expired on in UTC.

fields

no

See field object

New / Update

A field array of custom fields to insert or update. Please see the field object below.

Fields Object

Name

Required

Limit

Default

Summary

id

yes

Integer

The field id of the field you wish to update. The field id must map to a valid field in the asset.

value

yes

Dropdown list - Integer
Checkbox - Boolean
Text box - Unlimited

The value of the custom field. The value is dependent on the field type.

Language
Credentials