POST

Calendar.Update

Alias of Calendar.Edit. Update an existing calendar appointment in the appointments table.

Permissions

  • User must be logged in with a valid bearer token.
  • Returned or changed records are limited by the user permissions, team access, folder access, and account settings.

Action

  • Updates the requested Calendar record after validating permissions and input fields.

Push Service

No push is sent because this function only reads data or returns helper information.

Automation

No automation is run for this function.

Special Instructions

  • Send the bearer token on protected calls with Authorization: Bearer YOUR TOKEN.
  • Send parameters as POST body fields exactly as documented.
  • Send date/time values in UTC Y-m-d H:i:s format when a date or datetime field is used.

Required Parameters

NameTypeSampleExplanation
appointment_id
post
int9001Appointment id to update.
title
post
stringtest add eventEvent title.
date
post
date2026-07-29Appointment date Y-m-d. Send date filters and date values as UTC Y-m-d H:i:s when the route accepts date/time; date-only table columns store the Y-m-d date part.
start_time
post
time04:00Start time H:i. Send time values as H:i:s. If the route also has a date field, send that date as UTC Y-m-d H:i:s.

Optional Parameters

NameTypeSampleWhat it gives
end_time
post
time04:30End time H:i. Send time values as H:i:s. If the route also has a date field, send that date as UTC Y-m-d H:i:s.
duration
post
int30Duration minutes.
appoinment_color
post
stringredColor label.
customer_id
post
int108545Optional customer id.

Authentication

Send the bearer token returned by Login in the request header.

Authorization: Bearer YOUR TOKEN

Sample Request

{
    "url": "\/app\/Calendar.Update",
    "method": "POST",
    "headers": {
        "Authorization": "Bearer YOUR TOKEN"
    },
    "body": {
        "appointment_id": "9001",
        "title": "test add event",
        "date": "2026-07-29",
        "start_time": "04:00",
        "end_time": "04:30"
    },
    "url_user": "https:\/\/{user}.bull36.com\/app\/Calendar.Update",
    "url_domain": "https:\/\/{domain}\/app\/Calendar.Update"
}

Endpoint

POST /app/Calendar.Update
POST https://{user}.bull36.com/app/Calendar.Update
POST https://{domain}/app/Calendar.Update

Sample Output

{
    "success": 1,
    "message": "Appointment updated successfully",
    "appointment_id": 9001
}

JavaScript Example

const token = 'YOUR TOKEN';
const body = new URLSearchParams();
body.set('appointment_id', '9001');
body.set('title', 'updated');
body.set('date', '2026-07-29');
body.set('start_time', '04:00');
const res = await fetch('/app/Calendar.Update', { method: 'POST', headers: { Authorization: 'Bearer ' + token }, body });
console.log(await res.json());

Error Example

{
    "success": 0,
    "message": "Appointment not found"
}