Skip to content

List Custom Field Definitions

GET https://api.prosperworks.com/developer_api/v1/custom_field_definitions

Custom Field Definitions specify account specific fields not included as part of the standard resource fields and allows Copper to be customized to your specific workflow. The Custom Field Definitions API allows you to retrieve the list of Custom Field Definitions associated with your Copper account.

Field Type Details
id number Unique identifier for the custom field definition.
name string Label for the custom field definition
data_type string enum The type of data that should be stored within this custom field. Possible values are: String, Text, Dropdown, Date, Checkbox, Float, URL, Percentage, Currency, Connect and MultiSelect
currency string enum The currency used for this custom field definition. Valid only when the data type is Currency.
options options array A list of possible dropdown options. Valid only when the data type is Dropdown.

Example Requests

Custom Field Definitions

1
2
3
4
5
curl --request GET "https://api.prosperworks.com/developer_api/v1/custom_field_definitions" \
  --header "X-PW-AccessToken: YOUR_TOKEN_HERE" \
  --header "X-PW-Application: developer_api" \
  --header "X-PW-UserEmail: YOUR_EMAIL_HERE" \
  --header "Content-Type: application/json"
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
[
  {
    "id": 100764,
    "name": "A Text Field",
    "data_type": "String",
    "available_on": [
      "company",
      "opportunity",
      "lead",
      "person"
    ]
  },
  {
    "id": 103481,
    "name": "A Text Area Field",
    "data_type": "Text",
    "available_on": [
      "lead",
      "company",
      "opportunity",
      "person"
    ]
  },
  {
    "id": 126240,
    "name": "Color option",
    "data_type": "Dropdown",
    "available_on": [
      "opportunity",
      "project"
    ],
    "options": [
      {
        "id": 167776,
        "name": "Yellow",
        "rank": 4
      },
      {
        "id": 167775,
        "name": "Orange",
        "rank": 3
      },
      {
        "id": 167774,
        "name": "Blue",
        "rank": 2
      },
      {
        "id": 167773,
        "name": "Green",
        "rank": 1
      },
      {
        "id": 167772,
        "name": "Red",
        "rank": 0
      }
    ]
  }
]