API v1 Reference

Update Custom Object

Updates the configuration of an existing custom object.

This API method supports partial updating. This means that you only need to send fields you wish to change. Sending a field with a blank value will overwrite the existing value with empty data.

Important: An object must be inactive before you can modify it.

Endpoint

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

Request

https://api.neoncrm.com/neonws/services/api/customObject/updateCustomObject?userSessionId=[session id]&customObject.objectLabel=Museum Visits&customObject.objectId=2

Response

{
  "updateCustomObjectResponse": {
    "operationResult": "SUCCESS",
    "responseDateTime": "2017-05-18T21:26:37.636+0000"
  }
}

Request Parameters

Parameter Required Description
customObject.objectId Required The ID of the object to be updated.
customObject.objectLabel This is the unique name used to identify the Custom Object in the Custom Objects list as well as in the left menu (if the object is added to the left menu).
customObject.objectDescription Optional description or notes about this Custom Object.
customObject.objectRecordName This is a non-unique Field Name for the First Record that appears in page layouts, key lists, related lists, lookups, and search results. This is the first column to be created in your table. In most cases, this will be your table’s primary key.
customObject.objectRecordDataType Possible values: TEXT or AUTO_NUMBER. This controls the data type for the column you created with the “customObject.objectRecordName” parameter. In most cases, you will want to use a value of 1 (Auto-Number).
customObject.ObjectRecordStartNumber Used if customObject.objectRecordDataType = 1. Must be an integer. Specify which number should be used as the starting point for your Auto-Number field.
customObject.objectRecordDisplayFormat Please refer to our guide: Custom Object Number Formats

customObject.AllowActivity Possible values: TRUE, FALSE. If this is turned on, this Custom Object will be available for use in Activities.
customObject.AllowReport Possible values: TRUE, FALSE. If this is turned on, this Custom Object will be exposed to the NeonCRM reporting interface.
customObject.addToNeonLeftMenu Possible values: TRUE, FALSE. If this is turned on, this Custom Object will be added to NeonCRM’s left-side navigation menu.
customObject.createWebhook Format: Valid URL. When a new record is created, Neon will pass the record as JSON to this URL.
customObject.updateWebhook Format: Valid URL. When a record is updated, Neon will pass the record as JSON to this URL.
customObject.deleteWebhook Format: Valid URL. When a record is deleted, Neon will pass the record ID as JSON to this URL.
customObject.isActive Possible values: TRUE, FALSE. Inactive Custom Objects are not visible to system users.

Error Codes

Code Text Description
20008 Object label name is required.
20009 Object label name is invalid.
20010 Object record name is requried.
20011 Object record name is invalid.
20012 Object record data type is required.
20013 Object record data type is invalid.
20014 Object record display format is required.
20016 Object record start number is required.
20017 Object record start number is invalid.
20018 Object id is requried.
20020 Object is active.
20019 Object id is invalid.