Git Integration for Jira Cloud Documentation

Indexing Triggers

On this page:

 


 

Understand Indexing Triggers

Indexing triggers (webhooks) activate immediate reindexing of your repositories from remote systems. Your git server sends near real-time data to Jira when git data changes, providing much faster updates than the default 5-minute polling interval.

Common trigger events

Configure webhooks to execute when:

  • A new commit is pushed
  • A pull request is opened
  • A branch is merged

You can create indexing triggers for individual repositories, and most git providers support account-level or organization-level webhooks.

Why use indexing triggers?

Without indexing triggers, Jira relies on default polling (usually 5 minutes). Users must wait for the next interval to see new commits or pull requests. With indexing triggers, Jira receives updates immediately.

 

Enable Indexing Triggers

You must enable indexing triggers before using this feature.

  1. From your Jira Cloud dashboard, go to AppsGit Integration: Repository browser.

  2. Click Indexing triggers in the sidebar.


  3. Click the Indexing triggers enabled toggle to enable or disable the feature.

 

Find the Webhook URL

Access the webhook URL from these locations:

From the Indexing Triggers Page

Go to AppsGit Integration for JiraSettingsIndexing triggers.


From the Repository List

  1. Go to the Manage repository page.
  2. Click a repository or integration.
  3. Find the Webhook URL field.


From Repository Settings

  1. Go to the git configuration page.
  2. Click ActionsShow integration repositories.


URL format

https://[your-cloud-domain-url]/api/1/webhook/reindex/install/<INSTANCE_ID>/<SECRET_KEY>

Example:

https://gitforjiracloud.bigbrassband.com/api/1/webhook/reindex/install/x5chdqpqln0j04xcgv02zy7h9/vfTmXtqIFyqeCYYS3WjLIn2RRz5rHSDO
Click the copy icon next to the Webhook URL to copy it to your clipboard.

Supported HTTP methods: GET, POST, PUT
Not supported: DELETE, HEAD

 

Choose a Webhook URL Level

Three webhook URL levels are available:

Level Scope Use Case
Install level All configured repositories Simplest setup; recommended for most users
Integration level Repositories within one integration When you need separate triggers per integration
Repository level Single repository only Granular control for specific repositories

Install Level (Recommended)

This default webhook URL triggers events for all configured repositories. It’s the easiest to configure.

Access location: Git Integration sidebar ➜ Indexing triggers


Integration Level

This webhook URL triggers events only for repositories within a specific integration.

Access location: Manage integrations page ➜ ActionsEdit integrationFeature Settings


Or: Manage integrations page ➜ click an integration ➜ Feature Settings


Repository Level

This webhook URL triggers events only for a single repository.

Access location: Manage repository page ➜ click a repository ➜ Webhook URL field



Repository IDs are extracted from all webhook types (including install level). Only repositories specified in the webhook are indexed, preventing unnecessary indexing of all repositories in large integrations.

Last updated: December 2025

Have feedback about this article? Did we miss something? Let us know!
On this page