Create a custom field value

To create a custom deal field value, the following permissions are required.

  • Deal permission: the user should have permission to manage deals.
  • Pipeline-specific permission: the user should have permission to manage the pipeline that the deal belongs to. If the user does not have the permission to manage the pipeline, limited deal data are returned with only id, title, and isDisabled set to 1.
  • When creating a field value for a multivalued field (checkbox, multiselect), values must be strings in an array, e.g. ["Option 1", "Option 2", "Option 4"], whether one value or multiple are being set.

📘

Regarding date and datetime

DATE: Allowed date formats are: YYYY-MM-DD, YYYY/MM/DD, or MM/DD/YYYY
DATETIME: Allowed datetime format is ISO only

{
    "dealCustomFieldDatum": {
        "dealId": "2",
        "customFieldId": "1",
        "fieldValue": "test title"
    }
}
{
    "dealCustomFieldDatum": {
        "dealId": "2",
        "customFieldId": "2",
        "fieldValue": "option 1"
    }
}
{
    "dealCustomFieldDatum": {
        "dealId": "2",
        "customFieldId": "3",
        "fieldValue": [
            "option 1",
            "option 3",
            "option 4"
        ]
    }
}
{
    "dealCustomFieldDatum": {
        "dealId": "1",
        "customFieldId": "4",
        "fieldValue": 9999,
        "fieldCurrency": "cad"
    }
}
{
    "dealCustomFieldDatum": {
        "dealId": "1",
        "customFieldId": "5",
        "fieldValue": "100.99"
    }
}
// Allowed date formats are: YYYY-MM-DD, YYYY/MM/DD, or MMDD/YYYY
{
    "dealCustomFieldDatum": {
        "dealId": "1",
        "customFieldId": "6",
        "fieldValue": "2018-12-31"
    }
}
{
    "dealCustomFieldDatum": {
        "dealId": "1",
        "customFieldId": "6",
        "fieldValue": "2020-05-19T02:45:00-05:00"
    }
}
{
    "dealCustomFieldDatum": {
        "dealId": "2",
        "customFieldId": "3",
        "fieldValue": [
            "option 1"
        ]
    }
}
Language
Authentication
Header
URL