Cloud Events

Google push webhook

Receives Gmail Pub/Sub pushes plus Google Calendar and Drive channel notifications. Production Gmail pushes require a Google-signed OIDC bearer token with the configured audience and service-account email. Calendar and Drive use X-Goog-Channel-Token plus an exact active watch binding. The query token is retained only for local Pub/Sub mocks. Events for unresolved accounts are acknowledged with 200 and dropped.

post/v1/webhooks/google

Request

  • Base URL: / (relative, and the document was published on a file host, not at the API’s origin)
  • URL: /v1/webhooks/google
  • Auth: none declared

Query parameters

tokenstring

Development webhook token.

Development-only shared token for local Gmail Pub/Sub mocks; production uses OIDC bearer authentication.

Request body

object required

Pub/Sub push envelope.

Response

Acknowledged: sync handshake, duplicate, or unresolved account (dropped).

Changes

No operation changes recorded.