---
title: "Watch Calendar"
method: POST
path: "/api/focused/tools/watch_calendar"
tags: ["focused-tools"]
---

# Watch Calendar

`POST /api/focused/tools/watch_calendar`

Register Google Calendar push notification webhook.

Registers a webhook channel with Google to receive real-time
calendar event updates instead of polling.

Identity Source (Increment 7D):
    - Primary: X-User-ID header (from MCP after JWT validation)
    - Fallback: payload.user_id (for backward compatibility)
    - Logs warning if fallback is used or mismatch detected

## Request body

- WatchCalendarRequest — Request model for watch_calendar endpoint.
  - `user_id` string, required — User ID for webhook registration

## Response `200`

Successful Response

- unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/priority-guard/apis/priority-guardian.md) · [All operations](https://skmtc.net/priority-guard/apis/priority-guardian/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/priority-guard/priority-guardian/revisions/8579218b716d/schema)