GitHub webhook indexing integration

On this page:

• Connect GitHub to Jira Cloud
• Configure repository-level webhooks
• Configure organization-level webhooks
• Post-setup tips
• Supported features

Connect GitHub to Jira Cloud

Prerequisites: Install the Git Integration for Jira app on your Jira Cloud instance.

1. Go to Apps ➜ Git Integration for Jira ➜ Settings ➜ Manage Integrations.

   
   

2. Click Add integration.

   
   

3. Select GitHub.com (or GitHub Enterprise Server for self-hosted installations).

   
   

4. Select the Webhook indexing panel.

   
   

   Webhook indexing has limited features but does not require firewall configuration.

5. Click Add integration. The webhook settings screen appears.

   
   

6. Do not click Finish yet. Copy the Webhook URL and Secret key, then configure webhooks in GitHub using the steps below.

Configure Repository-Level Webhooks

1. Open your GitHub repository.

2. Go to Settings ➜ Webhooks.

   
   

3. Click Add webhook.

   
   

4. Configure the webhook:

   a. Paste the Webhook URL in the Payload URL box.

   b. Select application/json as the Content type. IMPORTANT

   c. Paste the Secret key in the Secret box.

5. Choose which events to trigger:

   Option	Description
   Just the push event	Sends triggers for commits and branches only
   Send me everything	Sends all events (may impact Jira performance) NOT RECOMMENDED
   Let me select individual events	Select Pushes and Pull requests RECOMMENDED

6. Click Add webhook to save.

7. Return to Jira and click Finish.

Configure Organization-Level Webhooks

1. Open your GitHub organization.

   
   

2. Go to Settings ➜ Webhooks.

   
   

3. Click Add webhook.

4. Configure the webhook using the same settings as repository-level (see steps 4-5 above).

5. Click Add webhook to save.

6. Return to Jira and click Finish.

Post-Setup Tips

• Organization-level webhooks apply to all repositories within the organization.
• If webhooks fail, verify the Payload URL, Secret key, and Content type settings.
• Find Webhook URL and Secret key in Actions ➜ Edit integration.
• IMPORTANT Repositories appear only after triggering push or pull request events.

Link Commits to Jira Issues

To display commits in Jira, include the Jira issue key in your commit messages. See Linking git commits to Jira issues.

Supported Features

The Git Roll Up tab is supported for GitHub webhook indexing integration.

Feature	Status
Works behind firewall	Supported
View commits, branches, pull requests	Supported
View tags	Coming soon
Automation for Jira triggers	Supported
Smart Commits	Supported
Repository Browser	Supported
Create branches/PRs in Jira	Not supported
View source code	Not supported
Full repository history	Not supported

Automation triggers supported:

• Commit created
• Branch created
• Pull request created
• Pull request declined
• Pull request merged

For complete feature details, see Feature matrix.

Related Articles

• GitLab webhook indexing integration
• Microsoft webhook indexing integration
• Gerrit webhook indexing integration

Last updated: December 2025