Webhooks provide a way for notifications to be delivered to an external web server whenever certain events occur on GitHub.
About webhooksWebhooks let you subscribe to events happening in a software system and automatically receive a delivery of data to your server whenever those events occur.
Webhooks are used to receive data as it happens, as opposed to polling an API (calling an API intermittently) to see if data is available. With webhooks, you only need to express interest in an event once, when you create the webhook.
Webhooks are used in a wide range of scenarios, including:
When you create a webhook, you specify a URL and subscribe to events that occur on GitHub. When an event that your webhook is subscribed to occurs, GitHub will send an HTTP request with data about the event to the URL that you specified. If your server is set up to listen for webhook deliveries at that URL, it can take action when it receives one.
For example, you could subscribe your webhook to events that occur when code is pushed to a repository, a pull request is opened, a GitHub Pages site is built, or a new member is added to a team. Your server could respond by deploying code to production, triggering a CI pipeline, sending a notification, or creating a GitHub project for the new team member.
You must create a webhook within a specific repository, organization, GitHub Marketplace account, GitHub Sponsors account, or GitHub App. The webhook can only access resources that are available in the repository, organization, GitHub Marketplace account, GitHub Sponsors account, or GitHub App where it is installed. For more information, see Types of webhooks.
For more information about creating webhooks, see Creating webhooks. For more information about the types of events you can subscribe to, see Webhook events and payloads. For more information about configuring your server to take an action in response to a payload delivery, see Handling webhook deliveries.
Note
GitHub webhooks do not currently support IPv6 but will in the future. The /meta
REST API endpoint returns IPv6 ranges to enable that transition.
Using webhooks has the following advantages over using the API:
If you only need information once or intermittently, or only want to get information from a small set of resources with no plans to scale up, you can call the API when you need the relevant information.
For information on best practices to follow when using webhooks, see Best practices for using webhooks.
Note
GitHub Services (sometimes referred to as Service Hooks) is retired, in favor of integrating with webhooks. For more information about migrating your integration from using GitHub Services to using webhooks, see the blog post.
Further readingRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4