Managing global webhooks

In this article

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 documentation."

For example, you can configure GitHub.com 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.

Adding a global webhook

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises.

  2. In the list of enterprises, click the enterprise you want to view.

  3. In the enterprise account sidebar, click Settings.

  4. Under " Settings", click Hooks.

  5. Click Add webhook.

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

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

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

  9. 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.

  10. 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.

  11. If you chose to select individual events, select the events that will trigger the webhook.

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

  13. Click Add webhook.

Editing a global webhook

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises.

  2. In the list of enterprises, click the enterprise you want to view.

  3. In the enterprise account sidebar, click Settings.

  4. Under " Settings", click Hooks.

  5. 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.

  6. Update the webhook's settings.

  7. Click Update webhook.

Deleting a global webhook

  1. In the top-right corner of GitHub.com, click your profile photo, then click Your enterprises.

  2. In the list of enterprises, click the enterprise you want to view.

  3. In the enterprise account sidebar, click Settings.

  4. Under " Settings", click Hooks.

  5. 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.

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

Viewing recent deliveries and responses

You can view details about webhook deliveries that occurred in the past 30 days. For more information, see "Viewing webhook deliveries."