If you've tried these fixes and still can't connect: Check status — Visit status.briefhq.ai for service status Contact support — Email hello@briefhq.ai with: - Which integration - What you tried - Screenshot of error (if any) - Your org ID (from Settings)

Troubleshooting Connections

Q: Why does my connection fail during OAuth?

OAuth flow fails or shows "Connection failed" error. Common Causes: Popup blocker preventing OAuth window Missing permissions in the connected tool Temporary service outage Fixes: Check popup blocker - Look for popup blocker icon in browser URL bar - Click and allow popups for Brief - Try connecting again Verify permissions - Ensure you have admin access to the tool you're connecting - For GitHub: Check that your org allows third-party apps - For Atlassian (Jira/Confluence): May need workspace admin approval Try again - Wait a few minutes - Clear browser cache - Try in an incognito/private window

Q: Why isn't any data syncing?

Integration connected but no data appears in Brief. Common Causes: Integration needs time for initial sync Webhook not registered properly Tool has no recent data to sync Fixes: Wait for initial sync Check integration status - Go to Integrations page in Brief - Look for sync status indicator - If "Error", try disconnecting and reconnecting Verify data exists - Check that the connected tool has recent activity - For Linear: Ensure issues exist from last 90 days - For GitHub: Ensure repo has recent PRs or commits

Q: Why is my data stale or out of date?

Data in Brief is out of date. Common Causes: Webhook stopped working Service temporarily down Rate limit hit Fixes: Trigger manual sync - Go to Integrations page - Click "Sync Now" next to the integration Reconnect - Disconnect the integration - Wait 30 seconds - Reconnect it

Q: Why does it say "Access Denied" during OAuth?

OAuth flow shows "Access denied" or permission error. Fixes: Verify admin access - Ensure you have admin/owner permissions in the tool - For GitHub orgs: Need org admin or owner role - For Atlassian: May need workspace admin Check app restrictions - Some orgs block third-party apps by default - GitHub: Check org settings → Third-party access - Atlassian: Check admin console → App management Request approval - For Atlassian tools, ask your workspace admin to approve Brief - Send them the Brief app page to review

Q: What should I do if popups are blocked?

Nothing happens when clicking "Connect". Fixes: Allow popups - Browser shows popup blocker icon in URL bar - Click it and select "Always allow popups from briefhq.ai" - Click "Connect" again Try different browser - Some browsers are more aggressive with popups - Try Chrome or Firefox if using Safari

Q: Why aren't my webhooks firing?

Initial sync worked but new changes don't appear. Fixes: Check webhook registration - For Linear: Settings → Webhooks → Look for Brief webhook - For GitHub: Repo → Settings → Webhooks → Look for Brief webhook Verify webhook URL - Webhook URL should include your org ID - Format: https://app.usebrief.com/api/webhooks/{tool}?org_id=YOUR_ORG_ID Reconnect integration - Disconnect in Brief - Wait 30 seconds - Reconnect (this re-registers webhooks)

Q: Why does Fireflies show "Invalid signature" error?

"Invalid signature" error in Fireflies integration. Fixes: Re-copy webhook secret - Go to Fireflies → Settings → Developer - After saving webhook, copy the secret shown - Paste it EXACTLY into Brief (no extra spaces) - Save in Brief Regenerate webhook - In Fireflies, disable webhook - Save - Re-enable webhook - Copy new secret - Update in Brief

Fix common integration issues and get your tools connected to Brief.

Last updated: November 25, 2025

Having trouble connecting a tool to Brief? This guide covers the most common issues and how to fix them.

General Issues

Why does my connection fail during OAuth?

OAuth flow fails or shows "Connection failed" error.

Common Causes:

Popup blocker preventing OAuth window
Missing permissions in the connected tool
Temporary service outage

Fixes:

- Look for popup blocker icon in browser URL bar - Click and allow popups for Brief - Try connecting again

Check popup blocker

- Ensure you have admin access to the tool you're connecting - For GitHub: Check that your org allows third-party apps - For Atlassian (Jira/Confluence): May need workspace admin approval

Verify permissions

- Wait a few minutes - Clear browser cache - Try in an incognito/private window

Try again

Why isn't any data syncing?

Integration connected but no data appears in Brief.

Common Causes:

Integration needs time for initial sync
Webhook not registered properly
Tool has no recent data to sync

Fixes:

Wait for initial sync

Integration	Expected Sync Time
Linear	30-60 seconds
GitHub	1-2 minutes
Notion/Confluence	2-5 minutes
Fireflies	Instant (webhook)
PostHog	1-2 minutes

- Go to Integrations page in Brief - Look for sync status indicator - If "Error", try disconnecting and reconnecting

Check integration status

- Check that the connected tool has recent activity - For Linear: Ensure issues exist from last 90 days - For GitHub: Ensure repo has recent PRs or commits

Verify data exists

Why is my data stale or out of date?

Data in Brief is out of date.

Common Causes:

Webhook stopped working
Service temporarily down
Rate limit hit

Fixes:

- Go to Integrations page - Click "Sync Now" next to the integration

Trigger manual sync

- Disconnect the integration - Wait 30 seconds - Reconnect it

Reconnect

OAuth Issues

Why does it say "Access Denied" during OAuth?

OAuth flow shows "Access denied" or permission error.

Fixes:

- Ensure you have admin/owner permissions in the tool - For GitHub orgs: Need org admin or owner role - For Atlassian: May need workspace admin

Verify admin access

- Some orgs block third-party apps by default - GitHub: Check org settings → Third-party access - Atlassian: Check admin console → App management

Check app restrictions

- For Atlassian tools, ask your workspace admin to approve Brief - Send them the Brief app page to review

Request approval

What should I do if popups are blocked?

Nothing happens when clicking "Connect".

Fixes:

- Browser shows popup blocker icon in URL bar - Click it and select "Always allow popups from briefhq.ai" - Click "Connect" again

Allow popups

- Some browsers are more aggressive with popups - Try Chrome or Firefox if using Safari

Try different browser

Webhook Issues

Why aren't my webhooks firing?

Initial sync worked but new changes don't appear.

Fixes:

- For Linear: Settings → Webhooks → Look for Brief webhook - For GitHub: Repo → Settings → Webhooks → Look for Brief webhook

Check webhook registration

- Webhook URL should include your org ID - Format: https://app.usebrief.com/api/webhooks/{tool}?org_id=YOUR_ORG_ID

Verify webhook URL

- Disconnect in Brief - Wait 30 seconds - Reconnect (this re-registers webhooks)

Reconnect integration

Why does Fireflies show "Invalid signature" error?

"Invalid signature" error in Fireflies integration.

Fixes:

- Go to Fireflies → Settings → Developer - After saving webhook, copy the secret shown - Paste it EXACTLY into Brief (no extra spaces) - Save in Brief

Re-copy webhook secret

- In Fireflies, disable webhook - Save - Re-enable webhook - Copy new secret - Update in Brief

Regenerate webhook

Tool-Specific Issues

Linear

"No issues synced"

Ensure Linear workspace has issues created in last 90 days
Check that you selected correct workspace during OAuth

"Webhook not working"

Go to Linear → Settings → Webhooks
Look for Brief webhook
If missing, disconnect and reconnect

GitHub

"Can't see my org"

You need admin access to the GitHub organization
Ask org admin to grant you permissions

"Wrong repo connected"

Disconnect integration in Brief
Reconnect and select correct repository
You can connect multiple repos by reconnecting

"Cross-referencing not working"

Include ticket IDs in PR titles: feat(BRI-123): Add feature
Brief looks for pattern: (TICKET-ID) in title

Notion

"No pages found"

In Notion, you must explicitly share pages with Brief integration
Go to page → Share → Invite "Brief" integration

"Missing content"

Check page permissions
Brief only sees pages explicitly shared with it
Share parent pages to include nested pages

Fireflies

"Transcripts not syncing"

Ensure webhook is enabled in Fireflies
Check "Transcription Completed" event is selected
Verify webhook URL includes your org ID

"No themes extracted"

Ensure meetings have actual transcription content
Check Fireflies settings to enable transcription for all meetings

PostHog

"Invalid API key"

Ensure you selected "MCP Server" scope when creating key
Try regenerating API key in PostHog

"No projects shown"

API key needs project:read permission
Create new API key with correct permissions

"No events synced"

Ensure PostHog project has events in selected time range
Check that PostHog is actually tracking events

Slack

"Bot not responding"

Re-add Brief to the channel: /invite @brief-bot
Check bot is installed in workspace

"Can't see /decide command"

Re-install Slack app
Slash command may not have registered properly

"Wrong workspace"

Disconnect in Brief
Reconnect selecting correct Slack workspace

Still Having Issues?

If you've tried these fixes and still can't connect:

- Which integration - What you tried - Screenshot of error (if any) - Your org ID (from Settings)

Check status — Visit status.briefhq.ai for service status
Contact support — Email hello@briefhq.ai with:

Sync Timing Reference

For reference, here's how long each integration takes:

Integration	Setup Time	Initial Sync	Updates
Linear	30 seconds	30-60 seconds	Real-time
GitHub	1-2 minutes	1-2 minutes	Real-time
Notion	30 seconds	2-5 minutes	Real-time
Confluence	30 seconds	2-5 minutes	Real-time
Jira	30 seconds	1-2 minutes	Real-time
Fireflies	3-5 minutes	Instant	Real-time
Fathom	30 seconds	1-2 minutes	Real-time
PostHog	2-3 minutes	1-2 minutes	Polling
Slack	1-2 minutes	Instant	Real-time