Webhook event catalogue

Connections events

connection.connected#

Account dataA storage account such as Google Drive was connected. Tokens are never included.

Account facts about the church, its keys and connections: ids, names the church chose, scopes, roles and states. Secrets, tokens and key values are never included.

data.object.object is connection.

Fields of data.object for connection.connected
Field	Type	Description
`account` required	`string`	The account label inside Folio.
`created_at` required	`string (date-time)`	When it was connected.
`id` required	`string`	The connection id.
`last_synced_at` required	`string (date-time) \| null`	When files last synced.
`object` required	`enum: connection`	Always connection.
`provider` required	`string`	The provider key.
`scopes` required	`string[]`	The permissions granted at the provider.
`status` required	`string`	The connection state, such as active or disconnected.

Example connection.connected body

{
  "actor": null,
  "api_version": "2026-12-01",
  "created": "2026-10-13T09:12:10Z",
  "data": {
    "object": {
      "account": "default",
      "created_at": "2026-10-13T09:12:10Z",
      "id": "con_0192f7a8-3b1c-7d2e-9a40-5c6d7e8f9012",
      "last_synced_at": "2026-10-13T09:12:10Z",
      "object": "connection",
      "provider": "gdrive",
      "scopes": [
        "drive.readonly"
      ],
      "status": "active"
    }
  },
  "id": "evt_0192f7a8-3b1c-7d2e-9a40-5c6d7e8f9012",
  "livemode": false,
  "object": "event",
  "request": {
    "id": "req_5f3c9a1e7b2d4c68a0e1f2d3c4b5a697",
    "idempotency_key": null
  },
  "type": "connection.connected"
}

connection.disconnected#

Account dataA storage account was disconnected.

Account facts about the church, its keys and connections: ids, names the church chose, scopes, roles and states. Secrets, tokens and key values are never included.

data.object.object is connection.

Fields of data.object for connection.disconnected
Field	Type	Description
`account` required	`string`	The account label inside Folio.
`created_at` required	`string (date-time)`	When it was connected.
`id` required	`string`	The connection id.
`last_synced_at` required	`string (date-time) \| null`	When files last synced.
`object` required	`enum: connection`	Always connection.
`provider` required	`string`	The provider key.
`scopes` required	`string[]`	The permissions granted at the provider.
`status` required	`string`	The connection state, such as active or disconnected.

On updates, data.previous_attributes holds the earlier value of any of these that changed: status.

Example connection.disconnected body

{
  "actor": null,
  "api_version": "2026-12-01",
  "created": "2026-10-13T09:12:10Z",
  "data": {
    "object": {
      "account": "default",
      "created_at": "2026-10-13T09:12:10Z",
      "id": "con_0192f7a8-3b1c-7d2e-9a40-5c6d7e8f9012",
      "last_synced_at": "2026-10-13T09:12:10Z",
      "object": "connection",
      "provider": "gdrive",
      "scopes": [
        "drive.readonly"
      ],
      "status": "active"
    },
    "previous_attributes": {
      "status": "Previous active"
    }
  },
  "id": "evt_0192f7a8-3b1c-7d2e-9a40-5c6d7e8f9012",
  "livemode": false,
  "object": "event",
  "request": {
    "id": "req_5f3c9a1e7b2d4c68a0e1f2d3c4b5a697",
    "idempotency_key": null
  },
  "type": "connection.disconnected"
}

Verified against API version 0.0.0-dev. Generated from the live OpenAPI document.