Skip to content

Updates a custom deal field.

Method update.deal_user_field
API version
Description Updates a custom deal field.

Available to: Agents and clients

Request parameters

Name Type Required Description
access_token string yes Access token used to authenticate the request.
user_id number no Unique ID of the client user on whose behalf the agent is making the request. Required for agents. To retrieve a list of client users, use "get.customer_users".
ext_id string yes External custom field ID.
name string yes Custom deal field name.

Example request

{
    "jsonrpc": "2.0",
    "id": "number",
    "method": "update.deal_user_field",
    "params": {
        "access_token":"string",
        "user_id":"number",
        "ext_id": "string",
        "name": "string"
    }
}

Example request with sample data

{
    "jsonrpc": "2.0",
    "id": "number",
    "method": "update.deal_user_field",
    "params": {
        "access_token":"string",
        "ext_id": "field_2021012203_3",
        "name": "Horses sold"
    }
}

Example response

{
    "jsonrpc": "2.0",
    "id": "number",
    "result": {
        "data": {
            "ext_id": "string"
        },
        "metadata": "object"
    }
}

Possible errors

See the "Errors for update methods" section.