Troubleshooting
Fixes for common issues and frequently asked questions
Fixes for the most common issues, plus answers to frequently asked questions. If your problem isn't covered here, reach us through the contact page and we'll help directly.
Common issues
My MCP client can't connect (401)
A 401 means the API key is missing, malformed, or revoked. Check that the Authorization header is exactly Bearer fb_sk_… with your full plaintext key. Keys are shown once at creation and can't be recovered — if you no longer have it, create a fresh key from Settings → Integrations → API & MCP. Revoked keys stop working on the very next request.
Tool calls fail with a scope error
Write tools (creating issues, updating status or priority) need a key created with the read + write preset. Scopes are fixed at creation, so a read-only key can't be upgraded — create a new key with the right preset and revoke the old one.
I keep hitting rate limits (429)
The MCP server enforces workspace-per-minute, workspace-per-day, and per-key-per-minute limits. A 429 carries a Retry-After header — well-behaved clients back off automatically. If you hit the daily ceiling regularly, batch your agent's activity or upgrade your plan for higher limits.
Feedback isn't creating issues in Linear, GitHub, or Jira
Check Settings → Integrations: the tracker must show as connected, and expired connections need a reconnect. Then check the channel's routing settings — issue creation is configured per channel, so a channel without a tracker mapping keeps its issues in Flowback only.
The intake page or widget isn't loading
Paused channels stop accepting submissions — check the channel's status first. For the embedded widget, confirm the embed snippet matches the current one under Sharing Channels, and that you're loading it from the domain you configured. Public intake is protected by bot detection, which can briefly challenge unusual traffic.
I've hit my plan's submission allowance
Each plan includes a monthly submission allowance. When you reach it you can upgrade the plan or add a one-time credit pack from Settings → Billing — packs apply immediately, on top of an active subscription.
FAQ
Can the API delete my data?
No. API and MCP tools can create and update issues, drafts, and comments, but they cannot delete data or modify workspace settings. Deletion stays a dashboard-only, human action.
Is my feedback used to train AI models?
No. Our AI providers process your data only to serve your requests and do not train their models on it. More detail on the security page.
Can I export my data?
Yes — your issues and submissions are readable in full through the API at any time. If you leave, contact us and we'll delete your workspace data.