PUT api/2.0/crm/{entityType}/customfield/{id} This function requires authentication

Description

Updates the selected custom field with the parameters (entity type, field title, type, etc.) specified in the request.

Parameters
Name Description Type Example
id
sent in url
Custom field ID number 1234
entityType
sent in url
New entity type
Allowed values: contact, person, company, opportunity, case
string some text
label
sent in body
New field title string some text
fieldType
sent in body
New custom field type
Allowed values: 0 (TextField), 1 (TextArea), 2 (SelectBox), 3 (CheckBox), 4 (Heading), or 5 (Date)
number 1234
position
sent in body
New field position
optional
number 1234
mask
sent in body
New mask
Sent in json format only
optional
string some text
Remark

You can update field if there are no related elements. If such elements exist, only label and mask will be updated. Other parameters will be ignored.

Example
PUT api/2.0/crm/%22some+text%22/customfield/1234
Host: yourportal.onlyoffice.com
Content-Type: application/json
Accept: application/json

{
  "label": "some text",
  "fieldType": 1234,
  "position": 1234,
  "mask": "some text"
}
Returns

Updated custom field

Example Response

application/json

{
  "status": 0,
  "response": {
    "RelativeItemsCount": 0,
    "id": 1234,
    "EntityId": 14523423,
    "Label": "Birthdate",
    "FieldValue": "2020-12-08T17:37:04.5916406Z",
    "FieldType": 5,
    "Position": 10,
    "Mask": ""
  }
}

text/xml

<result>
  <status>0</status>
  <response>
    <RelativeItemsCount>0</RelativeItemsCount>
    <id>1234</id>
    <EntityId>14523423</EntityId>
    <Label>Birthdate</Label>
    <FieldValue>2020-12-08T17:37:04.5916406Z</FieldValue>
    <FieldType>5</FieldType>
    <Position>10</Position>
    <Mask />
  </response>
</result>