Update deal

Modifies an existing deal

Function UpdateDeal(Val URL, Val DealID, Val FieldsStructure, Val Token = "") Export

Parameter	CLI option	Type	Required	Description
URL	--url	String	✔	URL of webhook or a Bitrix24 domain, when token used
DealID	--deal	Number, String	✔	Deal ID
FieldsStructure	--fields	Structure Of KeyAndValue	✔	Deal fields structure
Token	--token	String	✖	Access token, when app auth method used

Returns: Map Of KeyAndValue - serialized JSON of answer from Bitrix24 API

tip

Method at API documentation: crm.deal.update

1C:Enterprise/OneScript code example

    FieldsStructure = New Structure;
    FieldsStructure.Insert("TITLE"      , "Sale in RUB");
    FieldsStructure.Insert("CURRENCY_ID", "RUB");
    FieldsStructure.Insert("OPPORTUNITY", 50000);

    URL    = "https://b24-ar17wx.bitrix24.by/rest/1/h0m...";
    DealID = "4820";

    Result = OPI_Bitrix24.UpdateDeal(URL, DealID, FieldsStructure);

    FieldsStructure.Insert("TITLE"    , "Future deal in RUB");
    FieldsStructure.Insert("BEGINDATE", "2025-01-01");

    URL    = "b24-ar17wx.bitrix24.by";
    Token  = "75d8c668006e9f06006b12e400000001000...";
    DealID = "4822";

    Result = OPI_Bitrix24.UpdateDeal(URL, DealID, FieldsStructure, Token);

Bash

    oint bitrix24 UpdateDeal \
     --url ""b24-ar17wx.bitrix24.by"" \
     --deal "4902" \
     --fields ""/tmp/shrqwaf4.yth.json"" \
     --token "***"

CMD/Bat

    oint bitrix24 UpdateDeal ^
     --url ""b24-ar17wx.bitrix24.by"" ^
     --deal "4902" ^
     --fields ""/tmp/shrqwaf4.yth.json"" ^
     --token "***"

Result

{
 "result": true,
 "time": {
  "start": 1757977084.53254,
  "finish": 1757977084.73322,
  "duration": 0.200685024261475,
  "processing": 0.179536819458008,
  "date_start": "2025-09-15T22:58:04+00:00",
  "date_finish": "2025-09-15T22:58:04+00:00",
  "operating_reset_at": 1757977684,
  "operating": 0.17952299118042
 }
}