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 "Permission levels for 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.

You'll need access to an external server and a familiarity with technical procedures in order to set up a new webhook. For help on building a webhook, including a full list of actions you can associate with, visit our Developer guide.