Disabling webhooks

You can disable a webhook to unsubscribe from events that occur on GitHub.

In this article

About disabling webhooks

You can disable a webhook that was previously enabled for a repository, organization, GitHub Enterprise, or GitHub App.

To disable a webhook, you can choose to deactivate or delete it. When you deactivate a webhook, the webhook deliveries will stop, and you can choose to reactivate the webhook at a later time. When you delete a webhook, it cannot be restored.

For more information, see About webhooks and Creating webhooks.

Disabling a repository webhook

To disable a repository webhook, you can deactivate or delete it. You must be a repository owner, or have admin access in the repository, to disable webhooks.

You can use the GitHub web interface or the REST API to delete a webhook for a repository. For more information about using the REST API to delete a repository webhook, see REST API endpoints for repository webhooks.

  1. On GitHub, navigate to the main page of the repository.

  2. Under your repository name, click Settings. If you cannot see the "Settings" tab, select the dropdown menu, then click Settings.

    Screenshot of a repository header showing the tabs. The "Settings" tab is highlighted by a dark orange outline.

  3. In the left sidebar, click Webhooks.

  4. Under "Webhooks", locate the webhook you'd like to disable.

  5. Disable the webhook by either deactivating or deleting it:

    1. To deactivate the webhook:
      1. Click Edit.
      2. Deselect Active.
      3. Click Update webhook.
    2. To delete the webhook, click Delete. This action cannot be undone.

Disabling an organization webhook

To disable an organization webhook, you can deactivate or delete it. Only organization owners can disable webhooks in an organization.

You can use the GitHub web interface or the REST API to delete an organization webhook. For more information about using the REST API to delete an organization webhook, see REST API endpoints for organization webhooks.

  1. In the upper-right corner of any page on GitHub, click your profile photo.
  2. Click Your organizations.
  3. To the right of the organization, click Settings.
  4. In the left sidebar, click Webhooks.
  5. Under "Webhooks", locate the webhook you'd like to disable.
  6. Disable the webhook by either deactivating or deleting it:
    1. To deactivate the webhook:
      1. Click Edit.
      2. Deselect Active.
      3. Click Update webhook.
    2. To delete the webhook, click Delete. This action cannot be undone.

Disabling a global webhook for a GitHub Enterprise

Enterprise owners can disable a global webhook in an GitHub Enterprise.

You can use the GitHub web interface or the REST API to disable a global webhook. For more information about using the REST API to disable a global webhook, see REST API endpoints for global webhooks.

  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. On the left side of the page, in the enterprise account sidebar, click Settings.

  3. Under " Settings", click Hooks.

  4. Under "Webhooks", locate the webhook you'd like to disable.

  5. Disable the webhook by either deactivating or deleting it:

    1. To deactivate the webhook:
      1. Click Edit.
      2. Deselect Active.
      3. Click Update webhook.
    2. To delete the webhook, click Delete. This action cannot be undone.

Disabling webhooks for a GitHub App

Each GitHub App has one webhook. You cannot delete the webhook, but you can deactivate the webhook. The owner of a GitHub App can deactivate the webhook the app. If an organization has designated any app managers for a GitHub App owned by the organization, the app managers can also deactivate the webhook for the app.

  1. In the upper-right corner of any page on GitHub, click your profile photo.

  2. Navigate to your account settings.

    • For an app owned by a personal account, click Settings.
    • For an app owned by an organization:
      1. Click Your organizations.
      2. To the right of the organization, click Settings.

  3. In the left sidebar, click Developer settings.

  4. In the left sidebar, click GitHub Apps.

  5. Next to the GitHub App that you want to deactivate the webhook for, click Edit.

  6. Under "Webhook," deselect Active to disable the webhook.

  7. Click Save changes.