Skip to main content

About webhooks

Webhooks provide a way for notifications to be delivered to an external web server whenever certain actions occur on a repository or organization.

Tip: Only members with owner privileges for an organization or admin privileges for a repository can manage webhooks for an organization. For more information, see "Roles in an organization."

Webhooks can be triggered whenever a variety of actions are performed on a repository or an organization. For example, you can configure a webhook to execute whenever:

  • A repository is pushed to
  • A pull request is opened
  • A GitHub Pages site is built
  • A new member is added to a team

Using the GitHub API, you can make these webhooks update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server.

To set up a new webhook, you'll need access to an external server and familiarity with the technical procedures involved. For help on building a webhook, including a full list of actions you can associate with, see "About webhooks."