Developer Tools
Docker Hub Webhooks
Container registry. Receive events when new images are pushed to repositories.
Connecting Docker Hub to Hookbase
Create a source in Hookbase first — it gives you an ingest URL to paste into Docker Hub. Then:
- 1In Docker Hub, open your repository and select the Webhooks tab
- 2Enter a name for the webhook
- 3Paste your Hookbase ingest URL as the Destination URL (max 255 characters)
- 4Click "Create". The webhook fires on every image push to the repository
Signature verification
Docker Hub does not sign its webhooks with an HMAC scheme, so a signing secret on the source would have nothing to verify. Use a custom source with no secret, and keep the ingest URL itself hard to guess.
How Docker Hub secures them instead: Docker Hub webhooks have no secret, signature or auth header. The ingest URL is the only credential, so rename the source slug to something unguessable (the default 'docker-hub' is easy to guess).
Docker Hub event types
1 of the events people route most often. Hookbase accepts every event Docker Hub sends, whether or not it is listed here.
push
An image was pushed to the repository
What a Docker Hub webhook looks like
A push payload. Hookbase stores the raw body exactly as it arrived, so this is also what you get back on a replay.
{
"push_data": {
"pushed_at": 1678901234,
"pusher": "developer",
"tag": "latest"
},
"repository": {
"comment_count": 0,
"date_created": 1678000000,
"description": "API service image",
"full_description": "API service image built from github.com/org/api",
"is_official": false,
"is_private": true,
"is_trusted": false,
"name": "api",
"namespace": "org",
"owner": "org",
"repo_name": "org/api",
"repo_url": "https://hub.docker.com/r/org/api",
"star_count": 42,
"status": "Active"
}
}Start receiving Docker Hub webhooks
Create a source, paste the URL into Docker Hub, and watch the first event arrive. The free tier includes 1,000 events a month.
Get Started Free