GitHub is a version management tool used by development teams. When multiple developers collaborate on a GitHub repository, tracking code changes across the team requires manual effort. EventBridge solves this by using an HTTP event source to integrate with GitHub, allowing developers to effectively follow code changes and improve collaboration efficiency.
How it works
EventBridge receives GitHub events through an HTTP/HTTPS event source that acts as a webhook endpoint. When an event occurs in your GitHub repository, GitHub sends a POST request to this endpoint, and EventBridge routes the event to your custom event bus. From there, you can create rules to forward events to downstream targets.
The integration requires three steps:
Create an HTTP event source in EventBridge to generate a webhook URL.
Add the webhook URL to your GitHub repository.
Verify that events flow from GitHub to EventBridge.
Prerequisites
Before you begin, make sure you have:
Activated EventBridge with the required RAM user permissions. For more information, see Activate EventBridge and grant permissions to a RAM user
A custom event bus. For more information, see Create a custom event bus
A GitHub account. For more information, visit GitHub
Step 1: Create an HTTP event source in EventBridge
Create an HTTP/HTTPS trigger event source in the EventBridge console. For detailed instructions, see Create a custom event source of the HTTP/HTTPS Events type.
Configure the following parameters:
| Parameter | Value |
|---|---|
| Request Type | HTTP & HTTPS |
| Request Method | POST |
| Security Configuration | Optional |
After the event source is created, find it in the event source list and click Details. Copy the Internet request URL -- this is the webhook URL that GitHub sends events to.
Step 2: Configure a webhook in GitHub
Log on to GitHub and open the target repository.
Click the Settings tab, then click Webhooks in the left-side navigation pane.
In the upper-right corner, click Add webhook and configure the following parameters: Click Add webhook to save.
Parameter Value Payload URL The Internet request URL copied from Step 1 Content type application/json Which events would you like to trigger this webhook? Just the push event. 
Push a change from your local repository to GitHub to trigger the webhook.
Step 3: Verify the integration
Log on to the EventBridge console.
In the top navigation bar, select the region where your custom event bus is deployed.
In the left-side navigation pane, click Event Buses.
In the left-side navigation pane, click Event Tracking to view incoming events. If the integration is working, the push event from GitHub appears in the event list.