This resource lists the custom fields in your workspace. Custom fields are properties on a Client that you can use to store metadata about them (e.g. “Website URL” or “Service Tier”).

The format and data-type of each custom field in your portal is stored in this _resource, while the _values for a custom field are stored directly on the Client resource.

To update the value of a custom field on a Client, you can call Update Client and include customFields in the body. See notes on Create a Client for an example on how to format the customFields object.

Properties

id string
The unique identifier for this item.

type string
The data-type of this Custom Field. Can be text, multiSelect, email, address, url, number, or phoneNumber.

name string
Display name of the field in your workspace.

key string
Unique identifier used by the API to denote this custom field in READ and UPDATE queries on Clients. key is auto-generated, typically a camelCase version of the name of the custom field. (e.g. Support Email -> supportEmail)

order number
Represents the visual ordering (zero-indexed) of this field amongst all custom fields on the client details page.

options array of custom field options
Only relevant for multiSelect fields. If present, represents the available options in the dropdown for that field. The structure of custom field options is defined in the Custom Field Options Resource.


{
    "data": [
        {
            "id": "3b0d0f5e-4821-46d9-88c5-2c5a6d7fb16c",
            "key": "notes",
            "name": "Notes",
            "type": "text",
            "order": 2,
            "object": "customField"
        },
        {
            "id": "9035a8a3-8a42-4a59-8f71-87ebb306434f",
            "key": "number",
            "name": "Number",
            "type": "number",
            "order": 5,
            "object": "customField"
        },
        {
            "id": "f865a61a-3ae9-4b05-9881-49acfc091a01",
            "key": "email",
            "name": "Email",
            "type": "email",
            "order": 3,
            "object": "customField"
        },
        {
            "id": "82ff4e96-05b4-4125-94fa-4de824df93e0",
            "key": "address",
            "name": "Address",
            "type": "address",
            "order": 6,
            "object": "customField"
        },
        {
            "id": "5f1c964a-ff41-4360-bf39-ef38cf9007ab",
            "key": "phoneNumber",
            "name": "Phone number",
            "type": "phoneNumber",
            "order": 0,
            "object": "customField"
        },
        {
            "id": "fc91d57b-17dc-44bc-b718-07fada44e90c",
            "key": "website",
            "name": "Website",
            "type": "url",
            "order": 4,
            "object": "customField"
        },
        {
            "id": "9d507aee-6d9a-4137-be79-8afa627607ae",
            "key": "tags",
            "name": "Tags",
            "type": "multiSelect",
            "order": 1,
            "options": [
                {
                    "id": "option-8fe34ae0-b163-482c-a289-91aa6ac41c67",
                    "key": "sampleTag",
                    "label": "Sample Tag",
                    "color": "rgba(144, 149, 157, 1)"
                }
            ],
            "object": "customField"
        }
    ]
}