Docs/Integrations/Sentry

Sentry

Turn Sentry errors into triage-ready drafts

The Sentry integration turns your Sentry issues and alerts into triage-ready drafts in Flowback. When Sentry detects a problem, Flowback creates a draft submission with a structured PRD, a suggested priority, and a link back to Sentry — so your team can review and approve it from the inbox without leaving Flowback.

Connecting Sentry

To connect Sentry:

  1. Navigate to Integrations in your dashboard
  2. Click Connect Sentry
  3. You'll be taken to Sentry to install the Flowback app
  4. Choose the Sentry organization to install into and confirm

Flowback automatically discovers the projects in that organization, ready to map to your channels.

Note
You install Flowback into a Sentry organization — every project in it is discovered automatically, and you choose which ones to import during configuration.

Configuration

After connecting, open Sentry Settings to map Sentry projects to Flowback channels. Each project has:

  • Channel — Where this project's issues and alerts become drafts. Leave it on Do not import to skip the project
  • Issues — Whether Sentry issues and error events are imported
  • Alerts — Whether Sentry event and metric alerts are imported
  • Enabled — Turn a mapping on or off without deleting it

Sentry signals always arrive as drafts for review — nothing is pushed back to Sentry.

Warning
You need at least one Flowback channel before you can route a Sentry project.

What gets created

Each Sentry signal becomes a draft submission in the routed channel, attributed to Sentry, with:

  • Title — The Sentry issue or event title
  • PRD — A structured spec covering summary, user impact, severity, business risk, acceptance criteria, and the technical evidence from Sentry
  • Suggested priority — Based on the Sentry level and how many users and occurrences are affected (regressed or escalating issues are raised)
  • Deep links — A link back to the Sentry issue, plus a session replay when one is available

Repeat errors

When the same issue happens again, Flowback updates the existing draft instead of creating a duplicate — refreshing its evidence, occurrence count, and suggested priority. A snoozed draft is brought back into the inbox if the issue keeps happening, and a draft you've already approved into an issue stays in sync with Sentry.

Disconnecting

You can disconnect Sentry at any time from the Integrations page. Disconnecting:

  • Stops new Sentry issues and alerts from creating or updating drafts
  • Removes the connection from Flowback
  • Does not delete any drafts, submissions, or issues already created in Flowback
  • Does not change anything in your Sentry organization

You can reconnect at any time. After reconnecting, re-map your Sentry projects to channels to resume importing.