Documentation

Platform

Connectors

Connectors bring knowledge into Swifbit. They are versioned packages that run in isolated processes, with schema-driven setup, encrypted credentials, and health monitoring.

Included connectors

Ten first-party connectors ship with Swifbit, each with a live API mode and a demo mode:

  • Helpdesks — Zendesk, Freshdesk, Zoho Desk
  • CRM — Zoho CRM
  • Email — Gmail, Outlook
  • Wikis & code — Notion, GitHub
  • Web & files — Website crawler, Local files

Installing

From Connectors, install a first-party connector from the catalog or upload a .swpkg package. Swifbit validates the package structure and connector identity before it can be enabled.

Connector packages are stored in the database and rehydrated on startup, so installed connectors persist across restarts and work across multiple instances.

Configuration & credentials

Each connector declares a configuration schema, so its setup form is generated automatically. Fields marked as secrets — API keys and tokens — are encrypted at rest and masked in every response.

Syncing & health

  • Run on-demand health diagnostics to confirm a connector loads and responds
  • Documents stream in with flow control and are recorded only after durable ingestion
  • Each source keeps a sync history with per-run import counts and duration

Building your own

Build custom connectors with the @swifbit/sdk. Each plugin emits a .swpkg archive you can install like any first-party connector.

shell
pnpm plugin:build   # each plugin emits a .swpkg
pnpm verify         # build + connector runtime-contract tests