API Docs / Schemas / CustomFieldDefinitionDto

CustomFieldDefinitionDto

Defines a custom field that can be attached to entities such as clients.
Custom fields allow tenants to capture additional data beyond the built-in fields.

Properties

Name Type Description
codestring

The unique code for this custom field definition

The unique code for this custom field definition

labelstring

The display label shown to users for this field

The display label shown to users for this field

entityTypeenum

Client

Client

dataTypeenum

Text Number Date Boolean Select MultiSelect TextArea Address Email

Text Number Date Boolean Select MultiSelect TextArea Address Email

optionsarray of string

The list of allowed options for Select and MultiSelect fields. Null for other data types.

The list of allowed options for Select and MultiSelect fields. Null for other data types.

clientTypesarray of enum

The types of clients this custom field is applicable to.
An empty list means the field is applicable to all client types.

PrivateLimitedCompany PublicLimitedCompany LimitedLiabilityPartnership Partnership Individual Trust Charity SoleTrader

The types of clients this custom field is applicable to.
An empty list means the field is applicable to all client types.

PrivateLimitedCompany PublicLimitedCompany LimitedLiabilityPartnership Partnership Individual Trust Charity SoleTrader

maxLengthinteger

Maximum character length for Text and TextArea types. Null means no limit.

Maximum character length for Text and TextArea types. Null means no limit.

linesinteger

Number of visible text lines for TextArea type. Null defaults to 3.

Number of visible text lines for TextArea type. Null defaults to 3.

displayWidthenum

Small Medium Large Full

Small Medium Large Full

booleanDisplayModeenum

Toggle Checkbox YesNo

Toggle Checkbox YesNo

customFieldGroupCodestring

The code of the group this field belongs to

The code of the group this field belongs to

hasValuesboolean

Whether any entities have values stored for this field. Only populated on detail responses.

Whether any entities have values stored for this field. Only populated on detail responses.

isArchivedboolean

Whether this custom field definition has been archived

Whether this custom field definition has been archived

sortOrderinteger

The display order of this field relative to other custom fields

The display order of this field relative to other custom fields

JSON Example

{
  "code": "string",
  "label": "string",
  "entityType": "Client",
  "dataType": "Text",
  "options": [
    "string"
  ]
}

Used By Operations

Contained in Schemas