Managing global webhooks

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.

   

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.

   

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.

   

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.

   

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.

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.

   

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.

   

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