{"id":1513,"date":"2026-01-17T07:27:57","date_gmt":"2026-01-17T07:27:57","guid":{"rendered":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/?p=1513"},"modified":"2026-01-24T06:28:19","modified_gmt":"2026-01-24T06:28:19","slug":"google-calendar-webhooks-sync-logic","status":"publish","type":"post","link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/kivicare-google-meet-telemed-woocommerce-addon\/documentation\/core-concepts-doc\/google-calendar-webhooks-sync-logic\/","title":{"rendered":"Google Calendar Webhooks & Sync Logic"},"content":{"rendered":"
\n

Google Calendar Webhooks<\/strong> (also known as Push Notifications<\/em>) allow Google to notify your KiviCare system whenever changes occur in calendar events. This ensures that appointments in KiviCare remain accurate and synchronized in real time.<\/p>\n\n\n\n

\n\n\n\n

How the Synchronization Works<\/strong><\/h2>\n\n\n\n
    \n
  1. Watch Channel Setup<\/strong>
    The plugin can create a watch channel<\/em> for each doctor\u2019s Google Calendar to monitor event changes.<\/li>\n\n\n\n
  2. Event Change Notification<\/strong>
    When an event is updated, deleted, or started in Google Calendar, Google sends a push notification to your KiviCare website.<\/li>\n\n\n\n
  3. Request Processing<\/strong>
    KiviCare receives the webhook request, identifies the related appointment, and applies the required updates within the system.<\/li>\n<\/ol>\n\n\n\n
    \n\n\n\n

    Supported Synchronization Scenarios<\/strong><\/h2>\n\n\n\n
    Scenario<\/span><\/th>KiviCare Action<\/span><\/th>Resulting Status<\/span><\/th><\/tr><\/thead>
    Event Updated<\/strong><\/td>Updates appointment date, time, or details.<\/td>Updated<\/td><\/tr>
    Event Deleted<\/strong><\/td>Marks the appointment as canceled or unlinked.<\/td>Canceled \/ Incomplete<\/td><\/tr>
    Participant Status Changed<\/strong><\/td>Tracks patient check-in or attendance.<\/td>Arrived \/ Checked-in<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

    <\/p>\n\n\n\n

    \n\n\n\n

    Security & Request Verification<\/strong><\/h2>\n\n\n\n

    Google includes specific HTTP headers in each webhook request, such as:<\/p>\n\n\n\n

      \n
    • X-Goog-Channel-ID<\/code><\/li>\n\n\n\n
    • X-Goog-Resource-ID<\/code><\/li>\n<\/ul>\n\n\n\n

      The plugin validates these headers to confirm that the request is genuine and originated from Google Calendar, preventing unauthorized or spoofed updates.<\/p>\n\n\n\n

      \n\n\n\n

      Configuration Notes (For Developers)<\/strong><\/h2>\n\n\n\n

      Webhook notifications are typically handled via the endpoint:<\/p>\n\n\n\n

      YOUR_SITE_URL\/wp-json\/kivicare\/v1\/settings\/googlemeet\/callback\n<\/code><\/pre>\n\n\n\n
      or a dedicated webhook route.<\/p>\n\n\n\n
      At present, the Google Meet Addon primarily relies on direct API synchronization<\/strong> during appointment create, update, and delete actions in KiviCare. To enable full real-time push-based synchronization, ensure your Google Cloud Project<\/strong> is configured to allow outbound notifications to your server domain.<\/p>\n<\/div>","protected":false},"excerpt":{"rendered":"
      Google Calendar Webhooks (also known as Push Notifications) allow Google to notify your KiviCare system whenever changes occur in calendar events. This ensures that appointments in KiviCare remain accurate and synchronized in real time. How the Synchronization Works Supported Synchronization Scenarios Scenario KiviCare Action Resulting Status Event Updated Updates appointment date, time, or details. Updated […]<\/p>\n","protected":false},"author":12,"featured_media":0,"parent":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[43],"tags":[],"class_list":["post-1513","post","type-post","status-publish","format-standard","hentry","category-core-concepts-doc"],"featured_image_src":null,"author_info":{"display_name":"wordpressadminiq","author_link":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/author\/wordpressadminiq\/"},"_links":{"self":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1513","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/users\/12"}],"replies":[{"embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/comments?post=1513"}],"version-history":[{"count":8,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1513\/revisions"}],"predecessor-version":[{"id":1601,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/posts\/1513\/revisions\/1601"}],"wp:attachment":[{"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/media?parent=1513"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/categories?post=1513"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/documentation.iqonic.design\/kivicare-wordpress\/wp-json\/wp\/v2\/tags?post=1513"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}