Developer Tools
CircleCI Webhooks
CI/CD platform. Receive events for pipeline completions, job status changes, and workflow updates.
Connecting CircleCI to Hookbase
Create a source in Hookbase first — it gives you an ingest URL to paste into CircleCI. Then:
- 1Go to CircleCI → Project Settings → Webhooks
- 2Click "Add Webhook" and paste your Hookbase ingest URL
- 3Enter a name and secret for signature verification
- 4Select the events (workflow-completed, job-completed)
- 5Add the secret to your Hookbase source
Signature verification
CircleCI signs its webhooks with HMAC-SHA256 in circleci-signature, and Hookbase has no verifier for that combination today. We would rather say so here than let a source report every event as verified while nothing was checked.
What you can do:
- Receive them on a
customsource with no signing secret. Hookbase still dedupes, retries, transforms, routes and replays them; it just does not vouch for the sender. - Set a signing secret anyway if CircleCI can be configured to send a hex HMAC-SHA256 of the raw body in
X-Signature,X-Webhook-SignatureorX-Hub-Signature-256— that is the one scheme the custom verifier implements. - Verify downstream: the original headers travel with the event, so your own service or a transform can check the signature itself. The key is at CircleCI → Project Settings → Webhooks → Secret.
- Narrow the blast radius with an IP allowlist and a hard-to-guess source slug.
CircleCI event types
2 of the events people route most often. Hookbase accepts every event CircleCI sends, whether or not it is listed here.
workflow-completed
A workflow completed (success or failure)
job-completed
A job completed (success or failure)
What a CircleCI webhook looks like
A workflow-completed payload. Hookbase stores the raw body exactly as it arrived, so this is also what you get back on a replay.
{
"id": "evt-123456",
"type": "workflow-completed",
"happened_at": "2024-01-15T10:30:00.000Z",
"webhook": {
"id": "wh-789",
"name": "Hookbase"
},
"workflow": {
"id": "wf-abc123",
"name": "build-and-test",
"status": "success",
"created_at": "2024-01-15T10:20:00.000Z",
"stopped_at": "2024-01-15T10:30:00.000Z",
"url": "https://app.circleci.com/pipelines/github/org/repo/42/workflows/wf-abc123"
},
"pipeline": {
"id": "pip-def456",
"number": 42,
"vcs": {
"branch": "main",
"commit": {
"subject": "Fix tests"
}
}
},
"project": {
"slug": "gh/org/repo",
"name": "repo"
}
}Start receiving CircleCI webhooks
Create a source, paste the URL into CircleCI, and watch the first event arrive. The free tier includes 1,000 events a month.
Get Started Free