Managing global webhooks

About global webhooks

You can use global webhooks to automatically monitor, respond to, or enforce rules for user and organization management for your enterprise. For example, you can configure your webhooks to execute whenever:

• A user account is created or deleted
• An organization is created or deleted
• A collaborator is added to or removed from a repository
• A repository is forked

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

Adding a global webhook

1. Navigate to your enterprise account by visiting https://HOSTNAME/enterprises/ENTERPRISE-NAME, replacing HOSTNAME with your instance's hostname and ENTERPRISE-NAME with your enterprise account's name.

2. In the enterprise account sidebar, click Settings.

   

3. Under " Settings", click Hooks.

   

4. Click Add webhook.

   

5. Type the URL where you'd like to receive payloads.

   

6. Optionally, use the Content type drop-down menu, and click a payload format.

   

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

   

8. Optionally, if you would not like GitHub Enterprise Server to verify SSL certificates when delivering payloads, click Disable SSL verification. Read the information about SSL verification, then click 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. Decide 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 whether to trigger this webhook for organization or user activity.

    

11. Confirm that the Active checkbox is selected (it is selected by default).

    

12. Click Add webhook.

Editing a global webhook

1. Navigate to your enterprise account by visiting https://HOSTNAME/enterprises/ENTERPRISE-NAME, replacing HOSTNAME with your instance's hostname and ENTERPRISE-NAME with your enterprise account's name.

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. Navigate to your enterprise account by visiting https://HOSTNAME/enterprises/ENTERPRISE-NAME, replacing HOSTNAME with your instance's hostname and ENTERPRISE-NAME with your enterprise account's name.

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. Navigate to your enterprise account by visiting https://HOSTNAME/enterprises/ENTERPRISE-NAME, replacing HOSTNAME with your instance's hostname and ENTERPRISE-NAME with your enterprise account's name.

2. In the enterprise account sidebar, click Settings.

   

3. Under " Settings", click Hooks.

   

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

   

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