GOgorgias
Custom Fields

Retrieve a custom field

Changed on
get/api/custom-fields/{id}

Request

Path parameters

idinteger required

The ID of the custom field to retrieve.

Response

The requested custom field.

idinteger required

ID of the custom field.

external_idstring

ID of the custom field in a foreign system (ex: Zendesk).

object_type'Ticket' | 'Customer' required
labelstring required

The name of the custom field.

descriptionstring

The description of the custom field.

priorityinteger required

Order in which custom fields are displayed.

requiredboolean required

Whether this custom field is required.

requirement_type'visible' | 'required' | 'conditional' required
created_datetimestring date-time required

When the custom field was created.

updated_datetimestring date-time required

When the custom field was last updated.

deactivated_datetimestring date-time

When the custom field was deactivated.

Example response

{
  "id": 123,
  "external_id": "custom-field-84203241",
  "label": "Test field",
  "description": "An amazing field description.",
  "priority": 1,
  "required": true,
  "definition": {
    "input_settings": {
      "placeholder": "Enter this here..."
    }
  },
  "created_datetime": "2019-01-02T03:04:05.123456",
  "updated_datetime": "2020-01-02T03:04:05.123456",
  "deactivated_datetime": "2021-01-02T03:04:05.123456"
}

Changes