Article version: Enterprise Server 2.15

This version of GitHub Enterprise will be discontinued on This version of GitHub Enterprise was discontinued on 2019-10-16. 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

Site administrators can view, add, edit, and delete global webhooks to track events at the instance level.

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

Adding a global webhook

  1. In the upper-right corner of any page, click .

    Rocketship icon for accessing site admin settings

  2. In the left sidebar, click Business.

    Business tab in the Site admin settings

  3. Under your business account's name, click Settings.

    Settings tab on the business account profile page

  4. In the left sidebar, click Hooks.

    Hooks tab in the business account settings sidebar

  5. Click Add webhook.

    Add webhook button on Webhooks page in Admin center

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

    Field to type a payload URL

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

    Drop-down menu listing content type options

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

    Field to type a string to use as a secret key

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

    Button for disabling SSL verification

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

  10. Decide if you'd like this webhook to trigger for every event or for selected events:

    Radio buttons with options to receive payloads for every event or 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 whether to trigger this webhook for organization or user activity.

    Checkboxes for organization and user events

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

    Selected Active checkbox

  13. Click Add webhook.

Editing a global webhook

  1. In the upper-right corner of any page, click .

    Rocketship icon for accessing site admin settings

  2. In the left sidebar, click Business.

    Business tab in the Site admin settings

  3. Under your business account's name, click Settings.

    Settings tab on the business account profile page

  4. In the left sidebar, click Hooks.

    Hooks tab in the business account settings sidebar

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

    Edit button next to a webhook

  6. Update the webhook's settings.

  7. Click Update webhook.

Deleting a global webhook

  1. In the upper-right corner of any page, click .

    Rocketship icon for accessing site admin settings

  2. In the left sidebar, click Business.

    Business tab in the Site admin settings

  3. Under your business account's name, click Settings.

    Settings tab on the business account profile page

  4. In the left sidebar, click Hooks.

    Hooks tab in the business account settings sidebar

  5. Next to the webhook you'd like to delete, click Delete.

    Delete button next to a webhook

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

    Pop-up box with warning information and button to confirm deleting the webhook

Viewing recent deliveries and responses

  1. In the upper-right corner of any page, click .

    Rocketship icon for accessing site admin settings

  2. In the left sidebar, click Business.

    Business tab in the Site admin settings

  3. Under your business account's name, click Settings.

    Settings tab on the business account profile page

  4. In the left sidebar, click Hooks.

    Hooks tab in the business account settings sidebar

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

    List of webhooks with links to view each webhook

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

    List of the webhook's recent deliveries with links to view details

Ask a human

Can't find what you're looking for?

Contact us