Flipper
Connectors

How connectors work

A connector is a read-only connection to one source. Flipper polls it, stores what is new as episodes, and never writes back.

Team versus personal

Gmail is the only per-person connector — your mail is yours, so each member connects their own. Every other source (Slack, Drive, Calendar, Notion, Jira, Trello, uploads) is a single shared workspace connection that an owner or admin sets up once for everybody.

Cadence and first sync

Every connector shares one hourly poll. The alignment is the point rather than the interval: staggered per-source schedules kept the database permanently awake, while identical wall-clock crons make the polls coincide and leave long idle stretches between them. Freshness between ticks comes from webhooks, not from a tighter poll — Slack Events and Google push notifications wake the matching connector within a minute.

SourceFreshness between pollsFirst sync
SlackEvents API, under a minutelast 24h
Google Drivepush notificationfiles changed in last 24h
Google Calendarpush notificationupcoming events
Gmailhourly polllast 24h
Notionhourly pollevery page shared with it
Jirahourly pollissues updated in last 24h
Trellohourly pollcards and comments touched in last 24h

Only Notion backfills on first connect, and deliberately so: a wiki's value is the pages already in it, whereas a 24-hour window on a stream source is what stops a backfill costing a fortune in synthesis and burying today's signal under two years of noise.

Connectors: connected sources first, then the catalog.
Connectors: connected sources first, then the catalog.

What Flipper reads

  • Public Slack channels only — never DMs, never private channels.

  • Notion pages you explicitly share with the integration.

  • Drive files the connecting account can already open.

  • Calendar events, including attendees, for scheduling context.

  • Jira issues the connecting account can see — summary, description and comments.

  • Trello cards on your open boards, with their list, description and comments.