Setup guide: Sentry Bridge for Jira

Connecting Sentry Bridge takes about ten minutes: install the app, create a Sentry internal integration, paste two values into Jira, and map a project. You need a Jira Cloud admin and a sentry.io organization on the Team, Business or Enterprise plan with permission to create integrations (Sentry org Owner or Manager). Sentry's free Developer plan doesn't include integrations, and self-hosted Sentry isn't supported in v1.

Step 1: Install the app and copy your webhook URL

1. Install Sentry Bridge for Jira from the Atlassian Marketplace.
2. Go to Jira settings (⚙) → Apps → Sentry Bridge.
3. Copy the Webhook URL shown at the top. It's unique to your site — treat it like a password and don't post it publicly.

Step 2: Create a Sentry internal integration

1. In Sentry, open Settings → Developer Settings → Custom Integrations → Create New Integration.
2. Choose Internal Integration and click Next.
3. Name: Jira (Sentry Bridge).
4. Webhook URL: paste the URL from Step 1.
5. Turn on Alert Rule Action (lets alert rules send to this integration).
6. Permissions: Project: Read (not used by the app's own API calls, but kept here in case Sentry requires it to enable the issue webhook below) · Issue & Event: Read & Write (Write is needed so resolving in Jira can resolve in Sentry) · Organization: Read · everything else: No Access.
7. Webhooks: tick issue (created, resolved, archived, unresolved) — not assigned, which the app ignores.
8. Click Save Changes. On the saved integration page, copy the Client Secret, and under Tokens copy the auth token (create one if none is listed).

Step 3: Connect Jira to Sentry

1. Back in Jira settings → Apps → Sentry Bridge, enter:
   • Sentry organization slug — the part after sentry.io/organizations/ in your Sentry URL, or <slug>.sentry.io.
   • Sentry base URL — leave as https://sentry.io unless your org is on a regional host (for example https://de.sentry.io).
   • Client secret and Auth token from Step 2.
2. Click Save, then Test Sentry connection. You should see your organization name.

Step 4: Map a Jira project

1. Open the Jira project → Project settings → Sentry Bridge (project admin or Jira admin).
2. Turn on Create work items from mapped Sentry projects.
3. Enter the Sentry project slug(s), for example backend, web-app.
4. Pick the issue type (for example Bug) and, optionally, a default priority.
5. Choose the dedupe rule, and whether regressions reopen the work item.
6. If your issue type has required custom fields, add one line per field, such as customfield_10051={{environment}}.
7. Click Save.

Step 5 (optional): Use an alert rule instead of every new issue

New issues in mapped projects already create work items through the issue webhook. To create tickets only for some alerts (for example "more than 100 events in 1 hour"):

1. In Sentry, go to Alerts → Create Alert → Issues.
2. Set your conditions, then under Then perform these actions pick Send a notification via an integration → Jira (Sentry Bridge).

Step 6: Test

Trigger a test error in a mapped Sentry project. A Jira work item should appear within about 30 seconds. Resolve it in Sentry, and the Jira work item should move to Done within seconds.

Troubleshooting

• No work item: check that the Sentry project slug matches, that the Jira project mapping is enabled, and the "Last event" line on the project settings page.
• HTTP 403 creating work items: give the app's user Browse Projects, Create Issues, Edit Issues, Link Issues, Transition Issues and Add Comments permissions in the project's permission scheme.
• Sentry shows webhook errors in Developer Settings → your integration → Dashboard: a slow first response after an idle period can time out on Sentry's side while the ticket is still created. If a ticket is actually missing, email support@integrationyard.com with the request id.
• Ad blockers: no action needed — the settings pages are Atlassian-hosted Forge UI with no third-party scripts.

Support · Product overview