diff --git a/content/rest/reference/apps.md b/content/rest/reference/apps.md index b2a93c8102..589e2ca1d4 100644 --- a/content/rest/reference/apps.md +++ b/content/rest/reference/apps.md @@ -69,7 +69,7 @@ Be sure to replace stubbed endpoints with production endpoints before deploying {% ifversion fpt or ghes > 2.22 or ghae %} ## Webhooks -{% data reusables.webhooks.webhooks-rest-api-links %} +A {% data variables.product.prodname_github_app %}'s webhook allows you to receive HTTP `POST` payloads whenever certain events happen for an app. {% data reusables.webhooks.webhooks-rest-api-links %} {% for operation in currentRestOperations %} {% if operation.subcategory == 'webhooks' %}{% include rest_operation %}{% endif %} diff --git a/content/rest/reference/orgs.md b/content/rest/reference/orgs.md index 1c382a4ae5..5850b9e0ce 100644 --- a/content/rest/reference/orgs.md +++ b/content/rest/reference/orgs.md @@ -41,7 +41,7 @@ The token used to authenticate the call must have the `admin:org` scope in order ## Webhooks -Organization webhooks allow you to receive HTTP `POST` payloads whenever certain events happen within the organization. Subscribing to these events makes it possible to build integrations that react to events on {% data variables.product.product_name %}. {% data reusables.webhooks.webhooks-rest-api-links %} +Organization webhooks allow you to receive HTTP `POST` payloads whenever certain events happen in an organization. {% data reusables.webhooks.webhooks-rest-api-links %} For more information on actions you can subscribe to, see "[{% data variables.product.prodname_dotcom %} event types](/developers/webhooks-and-events/github-event-types)." diff --git a/content/rest/reference/repos.md b/content/rest/reference/repos.md index 2101fe9391..856d3867ec 100644 --- a/content/rest/reference/repos.md +++ b/content/rest/reference/repos.md @@ -304,10 +304,12 @@ to the information provided in your repository graph. For more information, see ## Webhooks -The Repository Webhooks API allows repository admins to manage the post-receive hooks for a repository. {% data reusables.webhooks.webhooks-rest-api-links %} Webhooks can be managed using the JSON HTTP API, or the [PubSubHubbub](#pubsubhubbub) API. +Repository webhooks allow you to receive HTTP `POST` payloads whenever certain events happen in a repository. {% data reusables.webhooks.webhooks-rest-api-links %} If you would like to set up a single webhook to receive events from all of your organization's repositories, see our API documentation for [Organization Webhooks](/rest/reference/orgs#webhooks). +In addition to the REST API, {% data variables.product.prodname_dotcom %} can also serve as a [PubSubHubbub](#pubsubhubbub) hub for repositories. + {% for operation in currentRestOperations %} {% if operation.subcategory == 'webhooks' %}{% include rest_operation %}{% endif %} {% endfor %} diff --git a/data/reusables/webhooks/webhooks-rest-api-links.md b/data/reusables/webhooks/webhooks-rest-api-links.md index 019d3a8044..49fc3c15dc 100644 --- a/data/reusables/webhooks/webhooks-rest-api-links.md +++ b/data/reusables/webhooks/webhooks-rest-api-links.md @@ -1,4 +1,5 @@ -The repository, organization, and app webhook REST APIs enable you to create, update, delete, and ping webhooks.{% ifversion fpt or ghes > 3.2 or ghae %} You can use this API to list webhook deliveries for a webhook, or get and redeliver an individual delivery for a webhook, which can be integrated into an external app or service.{% endif %}{% ifversion fpt or ghes > 2.22 or ghae %} You can also use the REST API to change the configuration of the webhook. For example, you can modify the payload URL, content type, SSL verification, and secret. {% endif %}For more information, see: +The webhook REST APIs enable you to manage repository{% ifversion ghes < 3.0 %} and organization{% else %}, organization, and app{% endif %} webhooks.{% ifversion fpt or ghes > 3.2 or ghae %} You can use this API to list webhook deliveries for a webhook, or get and redeliver an individual delivery for a webhook, which can be integrated into an external app or service.{% endif %}{% ifversion fpt or ghes > 2.22 or ghae %} You can also use the REST API to change the configuration of the webhook. For example, you can modify the payload URL, content type, SSL verification, and secret.{% endif %} For more information, see: + - [Repository Webhooks REST API](/rest/reference/repos#webhooks) - [Organization Webhooks REST API](/rest/reference/orgs#webhooks){% ifversion fpt or ghes > 2.22 or ghae %} -- [GitHub App Webhooks REST API](/rest/reference/apps#webhooks){% endif %} +- [{% data variables.product.prodname_github_app %} Webhooks REST API](/rest/reference/apps#webhooks){% endif %}