HAhappyscribe
Calendar connections

Calendar connected

Sent when a member finishes consent and their calendar starts syncing, including a reconnect of a connection in error.

Delivered to every workspace webhook endpoint subscribed to this event, signed with the endpoint's whsec_ secret. See Webhooks for signature verification, retries, and ordering.

postWebhookcalendar_connection.connected

Payload

idstring

Stable typed event ID beginning with evt_. Use it to deduplicate retries.

type'calendar_connection.connected' | 'calendar_connection.disconnected' | 'calendar_connection.error'

The event type. Also sent in the X-HappyScribe-Event header.

  • calendar_connection.connected: the member finished consent, including a reconnect.
  • calendar_connection.disconnected: the connection was disconnected, or the member removed.
  • calendar_connection.error: the calendar stopped syncing.
created_atstring date-time

When the event happened, in ISO 8601.

Example payload

{
  "data": {
    "object": {
      "workspace_id": "wks_01k6a2r9s8x7c2dvq3m5n6p4ab"
    }
  }
}

Response

Return any 2xx status to acknowledge receipt. Any other status, or a timeout, triggers a retry — up to 21 attempts with backoff.

Changes

Webhooks have no change history: a webhook is keyed by its event name rather than a path and method, so no recorded change can name it.