Skip to main content
Nous publions des mises à jour fréquentes de notre documentation, et la traduction de cette page peut encore être en cours. Pour obtenir les informations les plus actuelles, consultez la documentation anglaise.
GitHub AE est actuellement en version limitée.

About webhooks

Dans cet article

Learn the basics of how webhooks work to help you build and set up integrations.

Remarque : les webhooks GitHub ne prennent actuellement pas en charge IPv6, mais le feront à l’avenir. Le point de terminaison d’API REST /meta retourne des plages IPv6 pour permettre cette transition.

Webhooks allow you to build or set up integrations, such as GitHub Apps or OAuth Apps, which subscribe to certain events on GitHub.com. When one of those events is triggered, we'll send a HTTP POST payload to the webhook's configured URL. Webhooks can be used to update an external issue tracker, trigger CI builds, update a backup mirror, or even deploy to your production server. You're only limited by your imagination.

Webhooks can be installed on GitHub Enterprise, an organization, a specific repository, or a GitHub App. Once installed, the webhook will be sent each time one or more subscribed events occurs.

You can create up to 250 webhooks for each event on each installation target (GitHub Enterprise Server instance, specific organization, or specific repository).

Events

Lors de la configuration d’un webhook, vous pouvez utiliser l’interface utilisateur ou l’API pour choisir les événements qui vous envoient des charges utiles. Seul l’abonnement aux événements spécifiques que vous prévoyez de gérer limite le nombre de requêtes HTTP adressées à votre serveur. Vous pouvez également vous abonner à tous les événements actuels et futurs. Par défaut, les webhooks ne sont abonnés qu'à l'événement push. Vous pouvez à tout moment modifier la liste des événements auxquels vous êtes abonné.

Each event corresponds to a certain set of actions that can happen to your organization and/or repository. For example, if you subscribe to the issues event you'll receive detailed payloads every time an issue is opened, closed, labeled, etc.

For a complete list of available webhook events and their payloads, see "Événements et charges utiles du webhook."

Ping event

Lorsque vous créez un nouveau webhook, nous vous envoyons un simple événement ping pour vous informer que vous avez correctement configuré le webhook. Cet événement n’est pas stocké et ne peut donc pas être récupéré via le point de terminaison de l’API Événements.

For more information about the ping event webhook payload, see the ping event.