The following macros are not currently supported in the header:
  • style

List profile fields

UNDER DEVELOPMENT

The following endpoint can be used to retrieve an array of profile fields for a given type of object.

GET /:object_type/profiles/fields

Where object_type describes the object you wish to get the profile fields for. We currently support the following object types:

  1. Company
  2. Contact
  3. Affiliation
  4. Prospect
  5. Issue
  6. Milestone

Parameters

Table of allowed parameters.

_fieldspartial stringAllows you to specify optional fields and linked objects to include in the response.

Handling the response

Below is a table of available response fields and objects that are returned within the response object of the returned object. The optional fields and objects can be requested in the _fields parameter; see included examples. Underlined values are default.

idunsignedThe profile field id. This can be used on other endpoints that accept the profile_value_id. For example, the update profile  value endpoint accepts this as a url path parameter.
field_typestringThe profile field type for this value. This can be

'text','integer','decimal','date','date_time','currency','lookup','structure','select','multi_select','hyperlink'

field_namestringThe extension field name assigned to it by you. e.g "My awesome custom field".
optionsarrayThe options for 'select' or 'multi_select' field type.
link_idunsignedIf the ID of the object the profile value is against.
link_typestringThe type of object the profile is against. e.g, job, contract, prospect or issue.
requiredstringThis indicates whether this profile field is required for the object.
lookup_typestringWhen lookup this will contain the lookups type. e.g, "company"
exportedstringThis indicates whether this profile field can be exported.
descrioptionstringThe description about this profile field.