Documentation/Integrations

Integrations

Connect your existing tools to build the knowledge graph automatically. Cograph uses read-only access to analyze signals from your data sources — nothing is stored that isn't needed for expertise mapping.

Privacy note: Cograph never reads message content or code content. It analyzes metadata: who creates what, who collaborates with whom, and in which topic areas. No PII is sent to AI APIs.

Google Workspace

AvailableSetup: 5 minutesSyncs: Daily

The foundational integration. Google Workspace syncs your employee directory (the source of truth for who is in your org), org chart, and Google Docs authorship signals.

What gets synced

DataDescriptionFrequency
Employee directoryNames, emails, job titles, departments, managersDaily
Organizational hierarchyReporting structure and manager relationshipsDaily
Google Docs ownershipDocuments created, heavily edited, or most recently touchedDaily
Google Drive metadataFile access patterns (not file contents)Daily

Permissions required

  • admin.directory.user.readonly — read user profiles and directory
  • admin.directory.group.readonly — read group memberships
  • drive.metadata.readonly — read file metadata (not content)

Setup

  1. Go to Settings → Integrations → Google Workspace
  2. Click Connect — you'll be redirected to Google OAuth
  3. Sign in with a Google Workspace Admin account
  4. Grant the requested permissions
  5. The initial sync runs automatically (10–30 min for large orgs)

A Google Workspace Admin account is required to authorize the integration. The connection is specific to your Google Workspace domain.

Slack

AvailableSetup: 3 minutesSyncs: Daily

Analyzes public Slack channel activity to build collaboration networks and identify communication-based expertise signals. No message content is stored.

What gets synced

DataDescriptionFrequency
Public channel membershipWhich channels each user is inDaily
Message metadataWho posts in which channels (timestamps, not text)Daily
Thread participationReply patterns indicating go-to expertsDaily
Mention patternsWho people tag when they need help with topicsDaily

Permissions required

  • channels:read — list public channels
  • users:read — read user profiles
  • channels:history — read message metadata (not content)
  • groups:read — list private channels (optional)

Setup

  1. Go to Settings → Integrations → Slack
  2. Click Connect — you'll be redirected to Slack OAuth
  3. Select the workspace to connect
  4. Grant the requested permissions
  5. Choose which channels to include in signal collection

Only public channels are analyzed by default. Private channel analysis requires an additional permission grant and is opt-in per channel.

GitHub

AvailableSetup: 5 minutesSyncs: Daily

Maps code ownership across repositories by analyzing commit history and pull request patterns. Provides the strongest signal for technical expertise scoring.

What gets synced

DataDescriptionFrequency
Repository listAll repositories the GitHub App can accessDaily
Commit historyAuthor, timestamp, and file paths touchedDaily
Pull request reviewsWho reviews whose codeDaily
Code ownershipDerived ownership scores per file and topic areaDaily

Permissions required

  • contents:read — read repository contents and commits
  • pull_requests:read — read PR history and reviews
  • metadata:read — read repository metadata

Setup

  1. Go to Settings → Integrations → GitHub
  2. Click Connect — you'll be redirected to install the GitHub App
  3. Select your GitHub organization or specific repositories
  4. Grant access to the repos you want analyzed
  5. Cograph creates account links between GitHub usernames and Cograph employees

Uses a GitHub App (not OAuth) for fine-grained repository-level access control. You can choose which repositories to include.

Sync Schedule

Cograph uses incremental syncing — only new activity is processed after the initial backfill.

Initial sync10–30 minutes after connecting

Full historical backfill — all commits, documents, messages

Daily syncBetween 2–5 AM (org timezone)

Incremental — only new activity since last sync

Manual syncOn-demand from Settings → Integrations

Forces an immediate incremental sync

Graph rebuildWeekly (Sundays)

Full recalculation of all expertise scores and relationships

Large organizations: Initial syncs for organizations with 500+ employees or 100+ repositories may take several hours. The graph will be incomplete until the initial sync finishes.

Troubleshooting

The integration shows "Error" status

OAuth tokens expire after 60 days. Go to Settings → Integrations and click Reconnect to reauthorize. This is expected behavior — we rotate tokens aggressively for security.

Some employees are missing from the knowledge graph

Account linking connects GitHub usernames and Slack handles to Cograph employee records via email matching. If an employee uses a different email for GitHub, go to Settings → Account Links and add the mapping manually.

Expertise scores seem too low / inaccurate

Scores improve as more integrations are connected. Connecting only GitHub will give technical expertise but miss documentation and communication signals. Connect all three integrations for the best results. Scores also take 1–2 weeks to stabilize as historical data is processed.