Skip to main content

Create a custom field

POST /api/2.0/crm/{entityType:(contact|person|company|opportunity|case)}/customfield

Creates a new custom field with the parameters (entity type, field title, type, etc.) specified in the request.

Request body​

entityType​

type: string

Entity type

Example: "string"

label​

type: string

Field title

Example: "string"

fieldType​

type: integer

Custom field type

Example: 0

position​

type: integer

Field position

Example: 0

mask​

type: string

Mask

Example: "string"

Request example​

{
  "entityType": "string",
  "label": "string",
  "fieldType": 0,
  "position": 0,
  "mask": "string"
}

Returns​

Custom field. A request that is not authenticated returns 401.

RelativeItemsCount​

type: integer

Example: 0

EntityId​

type: integer

Example: 14523423

Label​

type: string

Example: "Birthdate"

FieldValue​

type: string

Example: "2020-12-08T17:37:04.5916406Z"

FieldType​

type: "TextField" | "TextArea" | "SelectBox" | "CheckBox" | "Heading" | "Date"

[0 - TextField, 1 - TextArea, 2 - SelectBox, 3 - CheckBox, 4 - Heading, 5 - Date]

Example: 5

Position​

type: integer

Example: 10

Mask​

type: string

Example: ""

ID​

type: integer

Example: 1234

Response example​

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