Integrations

Connect Runsheet to your data sources to automatically sync metrics and key result values. This eliminates manual data entry and ensures your OKRs reflect reality.

Available Integrations

  • PostHog - Sync product analytics insights to metrics and key results
  • Stripe - Track MRR, ARR, churn rate, and customer counts
  • Google Search Console - Monitor organic search clicks, impressions, and CTR
  • Linear - Link objectives to Linear initiatives for progress tracking and updates

Linear Integration

The Linear integration connects your strategic objectives to your delivery work. Link objectives to Linear initiatives to see progress, status, and receive updates from your team.

Connecting Linear

  1. Go to Settings → Integrations
  2. Click "Connect" on the Linear card
  3. Authorize Runsheet to access your Linear workspace
  4. Once connected, you can link objectives to initiatives

Linking Objectives to Initiatives

When editing an objective, use the Linear initiative picker to select an initiative. The objective page will then show initiative progress, status, and the latest updates from your team.

What Gets Synced

  • Initiative progress percentage
  • Status (Planned, In Progress, Completed)
  • Number of projects in the initiative
  • Latest initiative updates from team members

Setting Up Integrations

Go to Settings → Integrations in your workspace to connect your data sources. Each integration requires authentication with the external service.

Linking Metrics to Data Sources

Once an integration is connected, you can link individual metrics to pull data automatically.

  1. Go to the Metrics page
  2. Click on a metric to open its detail panel
  3. Click "Edit" to enter edit mode
  4. Use the "Data Source" dropdown to select an integration
  5. Choose the specific insight or metric type to sync
  6. Save your changes

Troubleshooting Sync Errors

If a metric fails to sync, here are the most common causes and solutions.

General Issues

  • No data source connected - The metric is not linked to an integration. Edit the metric and select a data source.
  • Configuration error - The integration or metric configuration is invalid. Try reconnecting the integration in Settings, or edit the metric and reselect the data source.
  • No data available - The data source returned no value. This may mean there is no data for the current period, or the insight may be misconfigured in the source system.

PostHog Issues

  • Connection failed - Could not connect to PostHog. Check your internet connection and verify the API key is still valid. Go to Settings → Integrations to reconnect.
  • Authentication failed (401/403) - The PostHog API key is invalid or expired. Generate a new personal API key in PostHog and reconnect the integration.
  • Insight not found - The linked insight was deleted or renamed in PostHog. Edit the metric and select a different insight.
  • Unsupported insight type - Runsheet only supports PostHog insights that return a single number, such as simple trend charts. Funnels, retention charts, and multi-series trends are not supported. Create a simpler insight in PostHog that shows a single total or count.
  • Rate limit exceeded (429) - Too many requests to PostHog. Wait a few minutes and try again.

Stripe Issues

  • Connection failed - Could not connect to Stripe. Check your internet connection and verify the API key is still valid in Settings.
  • API error - Stripe returned an error. Verify your restricted API key has the required read permissions for the data you are trying to access.

Google Search Console Issues

  • Connection error - Could not fetch data from Google Search Console. Try reconnecting the integration in Settings. You may need to reauthorize Runsheet to access your Search Console data.
  • No data available - Search Console data is typically delayed by 2-3 days. If you have just connected the integration, wait a few days for data to appear.