OpenIntegrations/docs/en/md/Bitrix24/Calendars-management/Set-custom-calendar-settings.mdx

---
sidebar_position: 7
---

import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# Set custom calendar settings
 Sets new custom calendar settings



`Function SetCustomCalendarSettings(Val URL, Val SettingsStructure, Val Token = "") Export`

  | Parameter | CLI option | Type | Required | Description |
  |-|-|-|-|-|
  | URL | --url | String | ✔ | URL of webhook or a Bitrix24 domain, when token used |
  | SettingsStructure | --settings | Structure Of KeyAndValue | ✔ | Settings structure (see GetCalednarCustomSettingsStructure) |
  | Token | --token | String | ✖ | Access token, when app auth method used |

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

<br/>

:::tip
Method at API documentation: [calendar.user.settings.set](https://apidocs.bitrix24.ru/api-reference/calendar/calendar-user-settings-set.html)
:::
<br/>



```bsl title="1C:Enterprise/OneScript code example"
    CalendarsStructure = New Structure;
    CalendarsStructure.Insert("view"              , "month");
    CalendarsStructure.Insert("showDeclined"      , "Y");
    CalendarsStructure.Insert("collapseOffHours"  , "N");
    CalendarsStructure.Insert("showCompletedTasks", "N");

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

    Result = OPI_Bitrix24.SetCustomCalendarSettings(URL, CalendarsStructure);

    URL   = "b24-ar17wx.bitrix24.by";
    Token = "67c7a767006e9f06006b12e400000001000...";

    Result = OPI_Bitrix24.SetCustomCalendarSettings(URL, CalendarsStructure, Token);
```