Skip to content

docs: clarify who can create a repository webhook - #26036

Merged
aevesdocker merged 2 commits into
docker:mainfrom
vdamery:docs/webhook-create-permissions
Sep 7, 2026
Merged

docs: clarify who can create a repository webhook#26036
aevesdocker merged 2 commits into
docker:mainfrom
vdamery:docs/webhook-create-permissions

Conversation

@vdamery

@vdamery vdamery commented Sep 7, 2026

Copy link
Copy Markdown
Contributor

Summary

  • Documents the permissions required to create a Docker Hub repository webhook: organization owner/editor, or a team member with Admin permissions on the repository (org repos), or the repository owner (personal repos, not collaborators).
  • Documents the required PAT/OAT scopes for creating webhooks via the API (repo:admin PAT scope / scope-webhook-edit OAT scope or higher).

This information was previously missing from the docs.

Test plan

  • npx --no-install rumdl fmt passes with no issues
  • Vale style check (not runnable in this environment; please verify in CI)

@netlify

netlify Bot commented Sep 7, 2026

Copy link
Copy Markdown

Deploy Preview for docsdocker ready!

Name Link
🔨 Latest commit 46bba68
🔍 Latest deploy log https://app.netlify.com/projects/docsdocker/deploys/6a9ed10959279700081f0935
😎 Deploy Preview https://deploy-preview-26036--docsdocker.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@github-actions github-actions Bot added the area/hub Issue affects Docker Hub label Sep 7, 2026
@vdamery
vdamery force-pushed the docs/webhook-create-permissions branch from f17a2cf to 76f4f4d Compare September 7, 2026 14:43
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.
@vdamery
vdamery force-pushed the docs/webhook-create-permissions branch from 76f4f4d to 3c67ef9 Compare September 7, 2026 14:48
Comment thread content/manuals/docker-hub/repos/manage/webhooks.md Outdated
Comment thread content/manuals/docker-hub/repos/manage/webhooks.md Outdated
Co-authored-by: Allie Sadler <102604716+aevesdocker@users.noreply.github.com>

@aevesdocker aevesdocker left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@aevesdocker
aevesdocker merged commit dc2f2c8 into docker:main Sep 7, 2026
24 of 25 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

area/hub Issue affects Docker Hub

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants