GET/contacts/custom-properties

Gets all the contact custom properties of a domain.

Authorization

oauth2

OAuth 2.0 authentication.
For more information, see Authentication and Authorization.

Scope

contact
contact.read

HTTP Request

GEThttps://www.worksapis.com/v1.0/contacts/custom-properties

Query Parameters

ParameterTypeDescription
domainId integer 

Domain ID


example : 10000001 

Header Parameters

HeadertypeDescription
Authorization string 

Bearer {token}


required 

Response

HTTP 200

OK

PropertyTypeDescription
customProperties array (ContactCustomProperty) 

Domain contact custom property information

 

ContactCustomProperty

PropertyTypeDescription
domainId integer 

Domain ID


format : int32 
customPropertyId string 

Custom property ID. It is automatically assigned.


readOnly : true 
propertyName string 

Custom property name.
It must be unique within a domain. The name can only contain English alphabet, numbers, and underscores (_). It must start with an alphabetic character or underscore (_).


maxLength : 120 
displayName string 

Custom property display name
It must be unique within a domain.


maxLength : 20 
i18nDisplayNames array (I18nDisplayName) 

List of multilingual display names


minItems : 0 
propertyType string 

Custom property type

  • STRING: Text
  • LINK: Hyperlink

Allowed values : STRING, LINK 
displayOrder integer 

Sort order. Duplicates are allowed and based on this value, custom properties are sorted in ascending order. If it is not specified (NULL), the custom property is located at the end of the list.


minimum : 1
format : int32
nullable : true 
multiValued boolean 

Indicates whether multiple values can be added for the same custom property.


default : false 

I18nDisplayName

PropertyTypeDescription
language string 

Language code


Allowed values : ko_KR, ja_JP, zh_CN, zh_TW, en_US 
name string 

Multilingual name


maxLength : 20 

Response Example

example

1{2  "customProperties": [3    {4      "domainId": 10000001,5      "customPropertyId": "custompi-5ge3-f6d7-ht33-35gr6e465u01",6      "propertyName": "ext_id",7      "displayName": "External ID",8      "i18nDisplayNames": [9        {10          "language": "ko_KR",11          "name": "External ID"12        },13        {14          "language": "en_US",15          "name": "external id"16        }17      ],18      "propertyType": "STRING",19      "displayOrder": 1,20      "multiValued": false21    },22    {23      "domainId": 10000001,24      "customPropertyId": "custompi-5ge3-f6d7-ht33-35gr6e465u02",25      "propertyName": "connect_link",26      "displayName": "External link",27      "propertyType": "LINK",28      "displayOrder": 2,29      "multiValued": false30    }31  ]32}

HTTP 404

Not Found