Sign in

v1

latestSwagger 2.0Private2026-08-04128286690.5 KB
Contacts Custom Fields

Update a custom field.

Update an existing custom field.

put/contact_custom_fields/{custom_field_id}

Path parameters

custom_field_idstring required

The ID that uniquely identifies the custom field to update.

Request body

labelstring

The custom field name to display in the UI (free-form text).

Example request

{
  "label": "Favorite color",
  "choices": [
    {
      "choice_id": 111,
      "choice_label": "Apple",
      "display_order": 1
    }
  ]
}

Response

Success - custom_field updated

custom_field_idstring uuid

The system generated ID that uniquely identifies a <code>custom_field</code>.

labelstring required

The custom field name to display in the UI (free-form text).

namestring

The unique custom field name constructed from the label by replacing blanks with underscores.

typestring required

The data value type the custom field accepts.

versioninteger

For <code>datetime</code> data types, this is the version number associated with the custom field.

updated_atstring date-time

System generated date and time that the resource was updated, in ISO-8601 format.

created_atstring date-time

Date and time that the resource was created, in ISO-8601 format. System generated.

Example response

{
  "custom_field_id": "1618ae62-4752-11e9-9c8a-fa163e6b01c1",
  "label": "Vehicle make and model year",
  "name": "Vehicle_make_and_model_year",
  "type": "date",
  "metadata": {
    "display_type": "radio",
    "decimal_places": 1,
    "currency_code": "USD",
    "integer": true,
    "display_format": "MM/DD/YYYY"
  },
  "version": 1,
  "choices": [
    {
      "custom_field_id": "d0737000-afbf-11ee-874a-eaf5d7a2e15d",
      "choice_label": "Apple",
      "display_order": 1,
      "created_at": "2024-06-27T10:28:09.000Z",
      "updated_at": "2024-06-27T10:28:09.000Z",
      "deleted_at": "2023-12-18"
    }
  ],
  "updated_at": "2016-01-23T13:48:44.108Z",
  "created_at": "2016-03-03T10:53:04-05:00"
}