Retrieve Custom Object Field

Retrieves a single field from a specific custom object.

Endpoint

https://api.neoncrm.com/neonws/services/api/customObject/retrieveCustomObjectField

Request

https://api.neoncrm.com/neonws/services/api/customObject/retrieveCustomObjectField?userSessionId=[session id]&objectApiName=Test_Custom_Object_c&objectFieldApiName=Related_Account_c

Response

{
  "retrieveCustomObjectFieldResponse": {
    "operationResult": "SUCCESS",
    "responseDateTime": "2017-05-23T17:29:20.847+0000",
    "customObjectField": {
      "fieldLabel": "Related Account",
      "fieldApiName": "Related_Account_c",
      "fieldDescription": "The Account to which my object is related.",
      "fieldHelpText": "Search for accounts.",
      "fieldDataType": "MASTER_DETAIL",
      "isInternal": false,
      "masterDetailFieldAttributes": {
        "relatedObjectApiName": "account_user",
        "reparentAllow": false,
        "deleteAction": "BLOCK",
        "relationFilter": {
          "errorMessage": "This is my error message.",
          "lookupWindowText": "lookup text",
          "relationFilterJsonString": "[{\"groupId\":\"1\",\"searchField\":\"\",\"criteriaField\":\"organizationType\",\"type\":\"2\",\"searchValue\":\"Association, Commercial Business, Corporate Sponsor, Government, Media, Not-for-profit, Religious Institution, School\",\"operator\":\"In Range Of\"},{\"groupId\":\"1\",\"searchField\":\"\",\"criteriaField\":\"id\",\"searchValue\":\"\",\"operator\":\"Not Blank\"},{\"groupId\":\"1\",\"searchField\":\"\",\"criteriaField\":\"email1\",\"searchValue\":\"\",\"operator\":\"Containing\"},{\"groupId\":\"1\",\"searchField\":\"lastName\",\"criteriaField\":\"companyName\",\"type\":\"1\",\"searchValue\":\"\",\"operator\":\"Equal\"}]"
        }
      }
    }
  }
}

Request Parameters

Parameter	Required	Description
objectApiName	Required	This is the token used to identify the Custom Object when accessing it from the API.
objectFieldApiName	Required	This is the API-specific name for the field being retrieved.

Response Parameters

Parameter	Description
customObjectField.fieldLabel	This is the unique name used to identify the field in the custom object. It will also be used in the data entry and data list pages.
customObjectField.fieldApiName	This is the API-specific name for the field being retrieved.
customObjectField.fieldDescription	On the data entry screen, this message shows up as the header content of the popup window when you click the magnifying glass to search this field.
customObjectField.fieldHelpText	This message shows up when you move the mouse over the corresponding question mark on the data entry form and listing page.
customObjectField.fieldDataType	Possible values: AUTO_NUMBER, TEXT, FORMULA, NUMBER, EMAIL, PHONE, URL, PERCENT, TEXTAREA_SHORT, TEXTAREA, DATE, DATETIME, CHECKBOX_SINGLE, CHECKBOX, DROPDOWN, RADIO, MASTER_DETAIL, LOOKUP. The type of data this field accepts.
customObjectField.isInternal	Possible values: TRUE, FALSE. Enable this if you want to make this field available only to system users and hide it from any public-facing web pages.
AUTO_NUMBER Fields
customObjectField.autoNumberFieldAttributes.startingNumber	Required	Must be an integer. Specify which number should be used as the starting point for your Auto-Number field.
customObjectField.autoNumberFieldAttributes.displayFormat	Required	Please refer to our guide: Custom Object Number Formats
FORMULA Fields
customObjectField.formulaFieldAttributes.formulaFieldReturnDataType	Required	Possible values: BOOLEAN, NUMBER, PERCENT, TEXT, DATETIME, DATE. The data type that should be returned and displayed.
customObjectField.formulaFieldAttributes.formulaExpression	Required	The formula to be used to calculate the value for this field. Use the formula building tool in NeonCRM’s custom objects interface to generate this formula.
MASTER/DETAIL Fields
customObjectField.masterDetailFieldAttributes.relatedObjectApiName	If this object is related to another object, that relationship will be shown here.
customObjectField.masterDetailFieldAttributes.reparentAllow	Possible values: TRUE, FALSE. Determines whether or not this child object record can be reassigned to a different parent object record after it has been created. (Example: Donations cannot be assigned to a different account after they have been created.)
customObjectField.masterDetailFieldAttributes.deleteAction	Possible Values: CASCADE, BLOCK. Cascade Delete allows deletion of this object’s records when its parent object record is deleted. Block requires that all of this object’s records be deleted before it’s parent object record can be deleted.
customObjectField.masterDetailFieldAttributes.relationFilter.errorMessage	Used if a lookup filter is defined. This message will display if the existing data on a Custom Object record no longer matches the defined search filter.
customObjectField.masterDetailFieldAttributes.relationFilter.lookupWindowText	Used if a lookup filter is defined. Use this field to define the header content of the Lookup Window. The text in this field will only display when the search filter captures 300 or more options.
customObjectField.masterDetailFieldAttributes.relationFilter.relationFilterJsonString	You can create a filter to limit the records available to users in the lookup field. This string is generated in NeonCRM’s user interface.
LOOKUP Fields
customObjectField.lookupFieldAttributes.relatedObjectApiName	Retrieve possible values from the List Objects API method. This is the object to which this object should become related.
customObjectField.lookupFieldAttributes.reparentAllow	Possible values: TRUE, FALSE. Determines whether or not this child object record can be reassigned to a different parent object record after it has been created. (Example: Donations cannot be assigned to a different account after they have been created.)
customObjectField.lookupFieldAttributes.relationFilter.relationFilterJsonString	You can create a filter to limit the records available to users in the lookup field.To do this, use NeonCRM’s lookup filter builder in the system user interface and provide the resulting JSON string here.
customObjectField.lookupFieldAttributes.relationFilter.errorMessage	Used if a lookup filter is defined. This message will display if the existing data on a Custom Object record no longer matches the defined search filter.
customObjectField.lookupFieldAttributes.relationFilter.lookupWindowText	Used if a lookup filter is defined. Use this field to define the header content of the Lookup Window. The text in this field will only display when the search filter captures 300 or more options.
TEXT Fields
customObjectField.textFieldAttributes.length	The maximum length of the field.
customObjectField.textFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.textFieldAttributes.isUnique	Possible values: TRUE, FALSE. When this is enabled, the field value must be unique in the entire custom object. A validation error will be thrown if duplicate values are detected.
customObjectField.textFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
NUMBER Fields
customObjectField.numberFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.numberFieldAttributes.length	If your number is an integer, leave Decimal Places to 0. If it’s a decimal, populate the limit for both Integer Part and Decimal Places. Possible values: 0-15.
customObjectField.numberFieldAttributes.decimalLength	The number of digits to the right of the decimal point. The combined length of the integer part and decimal places should be less than or equal to 15.
customObjectField.numberFieldAttributes.isUnique	Possible values: TRUE, FALSE. When this is enabled, the field value must be unique in the entire custom object. A validation error will be thrown if duplicate values are detected.
customObjectField.numberFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
customObjectField.numberFieldAttributes.displayFormat	Please refer to our guide: Custom Object Number Formats
EMAIL Fields
customObjectField.emailFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.emailFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
PHONE Fields
customObjectField.phoneFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.phoneFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
URL Fields
customObjectField.urlFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.urlFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
PERCENT Fields
customObjectField.percentFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.percentFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
customObjectField.percentFieldAttributes.length	Character limit of the integer part. Possible values: 1-15.
customObjectField.percentFieldAttributes.decimalLength	The number of digits to the right of the decimal point. The combined length of the integer part and decimal places should be less than or equal to 15.
TEXTAREA_SHORT Fields
customObjectField.textareaShortFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
customObjectField.textareaShortFieldAttributes.length	Must be less than or equal to 1024.
TEXTAREA Fields
customObjectField.textareaFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.textareaFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
customObjectField.textareaFieldAttributes.length	Must be less than or equal to 131072.
DATE Fields
customObjectField.dateFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.dateFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
customObjectField.dateFieldAttributes.displayFormat	Display format for this date. Example: {MM}/{DD}/{YYYY} results in 05/20/2017.
DATETIME Fields
customObjectField.datetimeFieldAttributes.defaultValue	A default value shows up automatically on the data entry form.
customObjectField.datetimeFieldAttributes.isRequired	Possible values: TRUE, FALSE. Make this field required on the data entry form.
customObjectField.datetimeFieldAttributes.displayFormat	Display format for this date. Example: {MM}/{DD}/{YYYY} {HH}:{mm}:{ss} for 05/20/2017 14:02:20.
CHECKBOX Fields
customObjectField.checkboxFieldAttributes.fieldOptionValues.fieldOptionValue.optionValue	The name of the option to be displayed and used internally.
customObjectField.checkboxFieldAttributes.fieldOptionValues.fieldOptionValue.sequence	Must be an integer. Determines the order in which the options will display.
customObjectField.checkboxFieldAttributes.fieldOptionValues.fieldOptionValue.isActive	Possible values: TRUE, FALSE. Determines whether this value shows up on the data entry form.
customObjectField.checkboxFieldAttributes.fieldOptionValues.fieldOptionValue.isDefault	Possible values: TRUE, FALSE. Determines whether this option is checked by default on the data entry form.
DROPDOWN (DROPDOWN) Fields
customObjectField.dropdownFieldAttributes.fieldOptionValues.fieldOptionValue.optionValue	The name of the option to be displayed and used internally.
customObjectField.dropdownFieldAttributes.fieldOptionValues.fieldOptionValue.sequence	Must be an integer. Determines the order in which the options will display.
customObjectField.dropdownFieldAttributes.fieldOptionValues.fieldOptionValue.isActive	Possible values: TRUE, FALSE. Determines whether this value shows up on the data entry form.
customObjectField.dropdownFieldAttributes.fieldOptionValues.fieldOptionValue.isDefault	Possible values: TRUE, FALSE. Determines whether this option is checked by default on the data entry form. Only one option may be specified as the default.
RADIO Fields
customObjectField.radioFieldAttributes.fieldOptionValues.fieldOptionValue.optionValue	The name of the option to be displayed and used internally.
customObjectField.radioFieldAttributes.fieldOptionValues.fieldOptionValue.sequence	Must be an integer. Determines the order in which the options will display.
customObjectField.radioFieldAttributes.fieldOptionValues.fieldOptionValue.isActive	Possible values: TRUE, FALSE. Determines whether this value shows up on the data entry form.
customObjectField.radioFieldAttributes.fieldOptionValues.fieldOptionValue.isDefault	Possible values: TRUE, FALSE. Determines whether this option is checked by default on the data entry form. Only one option may be specified as the default.

Error Codes

Code	Text	Description

API v1 Reference

Endpoint

Request

Response

Request Parameters

Response Parameters

Error Codes