UpdateCalendarEvent

Function to update a calendar event or a recurring series. Only the fields sent in the request are changed. The change is also made in the owner's Google and Microsoft calendar

PUT https://rest.crmango.com/api/UpdateCalendarEvent

Authorization1 Body data20 Response7 Example request

Authorization

1 Sent in the request headers

Bearer varchar

Auth token (required in Authorization header)

Body data

20 Sent in the request body

event_id integer

ID of the event to update (required)
Reference: GetAllCalendarEvents

update_scope varchar

single (default) = only this event, a series event is detached from its series. series = this event and all future events of the series; date_from shifts all dates by the same time and date_to sets the new length

owner_id integer

User ID whose calendar the event belongs to
Reference: GetAllUsers

title varchar

Event title, max 255 characters. Characters ' " ; \ ? / @ # $ = > < are removed

date_from varchar

Event start - unix timestamp or date and time, e.g. 2026-10-07 14:00

date_to varchar

Event end - same format. If equal to date_from, the event lasts 1 hour

description varchar

Event description (plain text, HTML tags are removed), max 10000 characters

type integer

Event type: 0 or omitted = automatic (up to 30 minutes = phone call, otherwise meeting), 1-99 basic type, 100+ custom activity type

is_private integer

Private event (0 = public, 1 = private)

company_id integer

ID of the related company

branch_id integer

ID of the related company branch

person_id integer

ID of the related person
Reference: GetAllPersons

guests array

List of guest e-mail addresses (max 100). On update the whole list is replaced, empty list removes the guests

color varchar

Event color in format #RRGGBB (empty, #fff and #ffffff = no color)

address varchar

Event address, max 255 characters

latitude decimal

Latitude (-90 to 90)

longitude decimal

Longitude (-180 to 180)

notification_type integer

Notification unit (1-4). Notification is set only if type, value and who are all filled

notification_value integer

How many units before the start the notification is sent (min 1)

notification_who integer

Who receives the notification (1-7)

Response

7 HTTP 200

Function to update a calendar event

code integer

HTTP status code (200 = OK)

message varchar

Info message

updated integer

Number of updated events

event_ids array

IDs of updated events

detached_from_series boolean

true if the event was removed from its series (update_scope single on a series event)

sync.google varchar

Synchronization with the owner's Google and Microsoft calendar: ok, failed, partial (series - only some dates), not_connected

sync.microsoft varchar

Synchronization with the owner's Google and Microsoft calendar: ok, failed, partial (series - only some dates), not_connected

Example request

curl --request PUT \
  --url 'https://rest.crmango.com/api/UpdateCalendarEvent' \
  --header 'Authorization: Bearer auth_token' \
  --header 'Content-Type: application/json' \
  --data '{
    {
        "event_id": 1301,
        "update_scope": "series",
        "title": "New title",
        "date_from": "2026-11-03 10:00",
        "date_to": "2026-11-03 11:30"
    }
  }'

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'https://rest.crmango.com/api/UpdateCalendarEvent',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'PUT',
  CURLOPT_POSTFIELDS => '{
    {
        "event_id": 1301,
        "update_scope": "series",
        "title": "New title",
        "date_from": "2026-11-03 10:00",
        "date_to": "2026-11-03 11:30"
    }
  }',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer auth_token',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

echo $response;

var data = JSON.stringify({
  {
      "event_id": 1301,
      "update_scope": "series",
      "title": "New title",
      "date_from": "2026-11-03 10:00",
      "date_to": "2026-11-03 11:30"
  }
});

var xhr = new XMLHttpRequest();
xhr.withCredentials = true;

xhr.addEventListener("readystatechange", function () {
  if (this.readyState === 4) {
    console.log(this.responseText);
  }
});

xhr.open("PUT", "https://rest.crmango.com/api/UpdateCalendarEvent");
xhr.setRequestHeader("Authorization", "Bearer auth_token");
xhr.setRequestHeader("Content-Type", "application/json");

xhr.send(data);

import requests
import json

url = "https://rest.crmango.com/api/UpdateCalendarEvent"

payload = json.dumps({
  {
      "event_id": 1301,
      "update_scope": "series",
      "title": "New title",
      "date_from": "2026-11-03 10:00",
      "date_to": "2026-11-03 11:30"
  }
})
headers = {
  'Authorization': 'Bearer auth_token',
  'Content-Type': 'application/json'
}

response = requests.request("PUT", url, headers=headers, data=payload)

print(response.text)

{
    "code": 200,
    "message": "Calendar event has been updated",
    "updated": 3,
    "event_ids": [
        1302,
        1303,
        1304
    ],
    "detached_from_series": false,
    "sync": {
        "google": "ok",
        "microsoft": "not_connected"
    }
}

{
    "code": "int",
    "message": "string"
}