Webhooks are an additional integration service available for most Git integrations. When enabled, webhooks help Flow keep your PR and ticket/issue data updated more frequently. If this service is not enabled, your pull request (PR) and ticket project data updates every three to four hours.
Note: Updates for organizations with large repos will take longer.
Webhook permission requirements
Each Git host is different, but there may be additional permissions needed to enable webhooks in your Flow account. Check out our articles on Repository Integrations for the necessary permissions for each Git Host.
There are a few things to keep in mind when you are attempting to enable webhooks within your Flow account:
- 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/group.
- At least one repo from the vendor org must be imported.
Once you have created an integration and given the service account the necessary permissions to enable webhooks, follow these steps to enable webhooks:
- On your Settings page, click Integrations
- Click on the integration you'd like to enable webhooks for
- 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 all the those that you'd like to install the webhooks for.
Alternatively, you can use the dropdown menu to install webhooks for multiple repos or organizations at once.
- You will see a check mark in the Installed column when your webhooks have been enabled.
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 Upgrade 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 will appear asking you to update your permissions.
In other cases, you may need to make some adjustments within your Git host or to your personal access token before continuing. If this is the case, once you have made those changes, click Refresh all projects for the specific integration you're looking at. Then you can see if your permissions changes adjusted what repos or organizations are available in the Webhooks tab.
If you need help, please email firstname.lastname@example.org for 24/7 assistance.