Webhooks are an additional integration service available for most Git integrations and may result in your commit, PR, and ticket data updating more frequently.
Note: Updates for organizations with large repos will take longer.
In this article
Permissions
Each Git host is different and there may be additional permissions needed to enable webhooks in your Flow account. Learn more about the necessary permissions for each Git host integration.
When you are attempting to enable webhooks within your Flow account, note that:
- For GitHub, Flow maintains webhooks for Git host organizations only, not individual repos.
- The service account used to establish the connection between Flow and the vendor must be the admin of the Git vendor organization or group.
- At least one repo from the vendor org must be imported.
Enabling webhooks
To enable webhooks, create an integration and give the service account the necessary permissions.
To enable webhooks:
- In the left navigation under Integrations, click Integrations.
- Click the integration you want to enable with webhooks.
- Find the Webhooks tab.
- Click Enable Webhooks
- If you have the required permissions, your repos or Git organizations will appear in a list in the Webhooks tab. Click Install for each integration you'd like to install the webhooks for.
Use the dropdown menu to install webhooks for multiple repos or organizations at once.
- When webhooks are enabled, the Installed column has a check mark.
Troubleshooting
If you do not see any repos or organizations listed in the Webhooks tab of your integration, you may need to upgrade your permissions.
You will see a notification if a permissions adjustment is needed. Click Update now to adjust your permissions.
Depending on your Git host, the next steps may vary. In some cases you may need to request additional permissions from a Git host admin.
For GitHub, a pop-up appears asking you to update your permissions.
You may need to make some adjustments within your Git host or to your personal access token before continuing. Once you have made those changes, click Refresh all projects for the specific integration you're looking at. After changing the permissions, navigate to the Webhooks tab to see what repos or organizations are available.