The GitHub integration captures activity from your repositories: pushes, pull requests, code reviews, and more. This is how Cogniscape answers what changed, who did it, how it was done, and when it happened.
This setup needs to be done once per repository you want to observe. If you add new repos later, just repeat the process for each one.
We never store any source code. Cogniscape only processes event metadata — commit hashes, PR titles, review comments, and similar structured data. Your code stays on GitHub. See Data Privacy for details. Open your repository settings
In GitHub, navigate to your repository and go to Settings → Webhooks → Add webhook.
Paste the Payload URL
Use the following URL, replacing <your-customer-key> with the key from the Customer Portal:https://api.cogniscape.app/api/v1/events/github/<your-customer-key>
Set Content type and Secret
- Content type: select
application/json
- Secret: leave empty
Choose which events to send
Select “Send me everything” for the richest insights. This ensures Cogniscape captures all relevant activity as it happens.If you prefer granular control, you can select specific events in the GitHub webhook creation panel. At a minimum, enable: push, pull_request, pull_request_review, pull_request_review_comment, issues, issue_comment, and deployment_status.
Make sure Active is checked, then save
That’s it. Events will start flowing into your knowledge graph immediately.
Verify the webhook
After saving, GitHub will send a ping event. You can check the delivery status under Settings → Webhooks → Recent Deliveries. A 200 response confirms Cogniscape received the event successfully.
Supported events
Cogniscape processes these GitHub webhook event types:
| Event | What it captures |
|---|
push | Commits pushed to any branch — who committed, when, and to which branch |
pull_request | PR creation, updates, merges, and closures — the full lifecycle |
pull_request_review | Code review submissions — approvals, change requests, and comments |
pull_request_review_comment | Inline code review comments on specific lines of a diff |
issues | Issue creation, updates, assignments, labeling, and closures |
issue_comment | Comments on issues and pull requests |
deployment_status | Deployment status notifications — success, failure, and pending states |
Events not listed above are received but silently ignored. Selecting “Send me everything” is safe — it won’t create noise in your knowledge graph.
Multiple repositories
Each repository needs its own webhook pointing to the same URL. The customer key in the URL ensures all events are routed to the correct knowledge graph regardless of which repository sends them.
For GitHub organizations with many repositories, consider using an organization-level webhook instead. Use the same Payload URL — Cogniscape handles both repository and organization webhooks identically. 
