From 3c67ef9b547fc8fca6131c18fa5f19600d8af114 Mon Sep 17 00:00:00 2001 From: Vincent DAMERY Date: Mon, 7 Sep 2026 16:40:05 +0200 Subject: [PATCH 1/2] docs: clarify who can create a repository webhook Add prerequisites documenting that webhook creation requires organization owner/editor/admin permissions (or repository ownership for personal repos), and the required PAT/OAT scopes for API access. --- .../manuals/docker-hub/repos/manage/webhooks.md | 17 +++++++++++++++++ 1 file changed, 17 insertions(+) diff --git a/content/manuals/docker-hub/repos/manage/webhooks.md b/content/manuals/docker-hub/repos/manage/webhooks.md index 0090bf5381e7..5580710156ca 100644 --- a/content/manuals/docker-hub/repos/manage/webhooks.md +++ b/content/manuals/docker-hub/repos/manage/webhooks.md @@ -9,6 +9,23 @@ aliases: You can use webhooks to cause an action in another service in response to a push event in the repository. Webhooks are POST requests sent to a URL you define in Docker Hub. +## Prerequisites + +For a personal repository, only the repository owner can create webhooks. +Collaborators can't create webhooks. + +For an organization repository, you must be an organization owner or editor, +or a team member with Admin permissions on the repository. For more details, +see [Organization teams](/manuals/docker-hub/repos/manage/access.md#organization-teams). + +To create a webhook using the Docker Hub API, authenticate with one of the +following: + +- A [personal access token](/manuals/security/access-tokens/personal-access-tokens.md) + with Delete permissions +- An [organization access token](/manuals/security/access-tokens/organization-access-tokens.md) + with the `scope-webhook-edit` scope or higher + ## Create a webhook To create a webhook: From 46bba68155794b66fc22eb4c2447cdbf7ead4d67 Mon Sep 17 00:00:00 2001 From: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> Date: Mon, 7 Sep 2026 15:58:15 +0100 Subject: [PATCH 2/2] Apply batched suggestions from code review Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com> --- content/manuals/docker-hub/repos/manage/webhooks.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/manuals/docker-hub/repos/manage/webhooks.md b/content/manuals/docker-hub/repos/manage/webhooks.md index 5580710156ca..784730bde800 100644 --- a/content/manuals/docker-hub/repos/manage/webhooks.md +++ b/content/manuals/docker-hub/repos/manage/webhooks.md @@ -15,14 +15,14 @@ For a personal repository, only the repository owner can create webhooks. Collaborators can't create webhooks. For an organization repository, you must be an organization owner or editor, -or a team member with Admin permissions on the repository. For more details, +or a team member with admin permissions on the repository. For more details, see [Organization teams](/manuals/docker-hub/repos/manage/access.md#organization-teams). To create a webhook using the Docker Hub API, authenticate with one of the following: - A [personal access token](/manuals/security/access-tokens/personal-access-tokens.md) - with Delete permissions + with delete permissions - An [organization access token](/manuals/security/access-tokens/organization-access-tokens.md) with the `scope-webhook-edit` scope or higher