Skip to main content

This version of GitHub Enterprise was discontinued on 2023-07-06. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise. For help with the upgrade, contact GitHub Enterprise support.

Managing global webhooks

You can configure global webhooks to notify external web servers when events occur within your enterprise.

Who can use this feature

Enterprise owners can manage global webhooks for an enterprise account.

About global webhooks

You can use global webhooks to notify an external web server when events occur within your enterprise. You can configure the server to receive the webhook's payload, then run an application or code that monitors, responds to, or enforces rules for user and organization management for your enterprise. For more information, see "Webhooks."

For example, you can configure your GitHub Enterprise Server instance to send a webhook when someone creates, deletes, or modifies a repository or organization within your enterprise. You can configure the server to automatically perform a task after receiving the webhook.

You can also use the GitHub Enterprise Server APIs to manage global webhooks. For a complete list of actions, see "GitHub Enterprise administration."

Adding a global webhook

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. In the enterprise account sidebar, click Settings.

  3. Under " Settings", click Hooks.

  4. Click Add webhook.

  5. In the "Payload URL" field, type the URL where you'd like to receive payloads.

  6. Optionally, select the Content type drop-down menu, and click a data format to receive the webhook payload in.

  7. Optionally, in the Secret field, type a string to use as a secret key.

  8. Optionally, if your payload URL is HTTPS and you would not like GitHub Enterprise Server to verify SSL certificates when delivering payloads, under "SSL verification", select Disable. Read the information about SSL verification, then click Disable, I understand my webhooks may not be secure.

    Warning: SSL verification helps ensure that hook payloads are delivered securely. We do not recommend disabling SSL verification.

  9. Under "Which events would you like to trigger this webhook?", select if you'd like this webhook to trigger for every event or for selected events.

    • For every event, select Send me everything.
    • To choose specific events, select Let me select individual events.
  10. If you chose to select individual events, select the events that will trigger the webhook.

  11. To make the webhook active immediately after adding the configuration, select Active.

  12. Click Add webhook.

Editing a global webhook

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. In the enterprise account sidebar, click Settings.

  3. Under " Settings", click Hooks.

  4. Next to the webhook you'd like to edit, click Edit.

    Screenshot of the "Webhooks" page. To the right of a webhook, the "Edit" button is highlighted with an orange outline.

  5. Update the webhook's settings.

  6. Click Update webhook.

Deleting a global webhook

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. In the enterprise account sidebar, click Settings.

  3. Under " Settings", click Hooks.

  4. Next to the webhook you'd like to delete, click Delete. Screenshot of the "Webhooks" page. To the right of a webhook, the "Delete" button is highlighted with an orange outline.

  5. Read the information about deleting a webhook, then click Yes, delete webhook.

Viewing recent deliveries and responses

  1. In the top-right corner of GitHub Enterprise Server, click your profile photo, then click Enterprise settings.

    Screenshot of the drop-down menu that appears when you click the profile photo on GitHub Enterprise Server. The "Enterprise settings" option is highlighted in a dark orange outline.

  2. In the enterprise account sidebar, click Settings.

  3. Under " Settings", click Hooks.

  4. In the list of webhooks, click the URL of the webhook for which you'd like to see deliveries.

    Screenshot of a list of global webhooks. The URL link to view a webhook is highlighted with an orange outline.

  5. Under "Recent deliveries", click a delivery GUID to view details.

    Screenshot of the "Recent deliveries" list for a global webhook. A delivery GUID in the list of deliveries is highlighted with an orange outline.