Skip to content

Update an existing custom field definition

PUT https://api.copper.com/developer_api/v1/custom_field_definitions/{{custom_field_definition_id}}

Field Type Details Default
name string Name of the Custom Field Definition
data_type string One of the following strings: "Checkbox", "Currency", “Date", "Dropdown", "Float", "MultiSelect", "Percentage", “String", "Text", "URL"
available_on string[] List of strings containing one or more of the following: “lead”, “person”, “opportunity”, “company”, "project", "task"
is_filterable boolean Indicates if the Custom Field Definition can be included in filters.
options number[] Array of options for Dropdown and MultiSelect fields. A minimum of one option is required for Dropdown and a minimum of 2 options is required for MultiSelect
currency string 3-letter currency code (e.g., "USD", "CAD")

Request Body

{
  "available_on": [ "lead", "person", "opportunity"],
  "is_filterable": true,
  "options": [
    {
        "name": "Option 1"
    },
    {
        "name": "Option 2"
    },
    {
        "name": "Option 3"
    }
  ]
}

Example Requests

Update options for an existing Dropdown Custom Field

curl --request PUT "https://api.copper.com/developer_api/v1/custom_field_definitions/3" \
  --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" \
  --data "{
  \"available_on\": [ \"lead\", \"person\", \"opportunity\"],
  \"is_filterable\": true,
  \"options\": [
    {
        \"name\": \"Option 1\"
    },
    {
        \"name\": \"Option 2\"
    },
    {
        \"name\": \"Option 3\"
    }
  ]
}"

{
    "id": 3,
    "name": "A Dropdown",
    "canonical_name": null,
    "data_type": "Dropdown",
    "available_on": [
        "lead",
        "person",
        "opportunity"
    ],
    "is_filterable": true,
    "options": [
        {
            "id": 7,
            "name": "Option 1",
            "rank": 0
        },
        {
            "id": 8,
            "name": "Option 2",
            "rank": 1
        },
        {
            "id": 9,
            "name": "Option 3",
            "rank": 2
        }
    ]
}

Update a String Custom Field

curl --request PUT "https://api.copper.com/developer_api/v1/custom_field_definitions/7" \
  --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" \
  --data "{
  \"name\": \"Renamed String\"
}"

{
    "id": 7,
    "name": "Renamed String",
    "canonical_name": null,
    "data_type": "String",
    "available_on": []
}