PHPackages pi-space/laravel-github-to-notion-webhooks - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. pi-space/laravel-github-to-notion-webhooks ActiveLibrary pi-space/laravel-github-to-notion-webhooks ========================================== This is my package laravel-github-to-notion-webhooks v1.0.0(2y ago)81MITPHPPHP ^8.1 Since Jul 23Pushed 2y ago1 watchersCompare [ Source](https://github.com/Eyadhamza/Laravel-Github-To-Notion-Webhooks)[ Packagist](https://packagist.org/packages/pi-space/laravel-github-to-notion-webhooks)[ Docs](https://github.com/pispace/laravel-github-to-notion-webhooks)[ RSS](/packages/pi-space-laravel-github-to-notion-webhooks/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (1)Dependencies (9)Versions (2)Used By (0) Laravel Github to Notion Webhooks ================================= [](#laravel-github-to-notion-webhooks) Welcome to the documentation for the Laravel Github to Notion Webhooks package! This simple package enables you to effortlessly sync events from GitHub, such as pull requests and issues, directly to Notion. By taking care of the configuration and syncing process, it allows you to focus on your work. Let's dive in and get started! The package leverages another package called [Laravel-Notion-Integration](https://github.com/Eyadhamza/Laravel-Notion-Integration), which allows you to interact seamlessly with the Notion API. Installation ------------ [](#installation) To begin using the package, install it via composer: ``` composer require pi-space/laravel-github-to-notion-webhooks ``` After installation, you'll need to publish the configuration file to customize the package settings: ``` php artisan vendor:publish --tag="laravel-github-to-notion-webhooks-config" ``` The published configuration file looks like this: ``` return [ 'github' => [ 'secret' => env('GITHUB_WEBHOOK_SECRET'), 'events' => [ 'issue' => true, 'pull_request' => true, ], ], 'notion' => [ 'databases' => [ 'issues' => 'cc66f47f03cb4b62a774f6d5f34463ce', 'pull-requests' => 'b99a0a1287d142bbbd7bec87fe1e6406', 'users' => '430cedc2495348df926ca520e1255182', ], ] ]; ``` The published config file contains two main sections: `github` and `notion`. ### GitHub Configuration [](#github-configuration) The `github` section specifies configurations for the GitHub webhook, including the events you want to listen to and the secret you'll use to verify webhook requests to your Laravel app. To use the package, you need to add the secret to your .env file. For more information about GitHub webhooks and how to set them up, refer to the GitHub documentation [here](https://docs.github.com/en/developers/webhooks-and-events/about-webhooks). In your GitHub repository settings, you need to do two things: 1. Add the URL of your Laravel app as the webhook URL, which will be the base URL of your app + `/github/webhooks`. For example: `https://example.com/github/webhooks`. 2. Specify the events that you want GitHub to send to your app. After doing so, add them to the events key in the config file, and if you want to disable any event, you can set its value to false. ### Notion Configuration [](#notion-configuration) The `notion` section specifies the Notion database IDs where you want to store the synced data. You can either create the Notion databases manually or use an artisan command that will generate the databases for you and return the IDs. If you choose the latter option, follow these steps: > Note that this will generate a specific database with predefined property names and types. If you want to customize the properties, please refer to the [\#customization](#customization) section. Note that the Users Database in Notion is mandatory, as it will be used to identify the GitHub username and map it to the Notion user. Make sure to populate the table manually, writing each GitHub username, and then mentioning the corresponding Notion user in the Person property. 1. Call the artisan command to create the databases in Notion and get the IDs: ``` php artisan notion:create-databases {parentPageId} ``` Note that `parentPageId` is the ID of the page where you want to create the databases. You can find this ID by going to the page, clicking on "Share," and copying the link. The ID is the last part of the link after the page name. > For Example, if the link is `https://www.notion.so/My-Page-Name-430cedc2495348df926ca520e1255182`, the ID is `430cedc2495348df926ca520e1255182`. The command will return something like this: ``` Issues database created successfully with id: cc66f47f03cb4b62a774f6d5f34463ce Pull Requests database created successfully with id: b99a0a1287d142bbbd7bec87fe1e6406 Users database created successfully with id: 430cedc2495348df926ca520e1255182 ``` 2. Paste the IDs in the config file under the `notion.databases` section as shown in the previous example. 3. Add the Notion API key and the database ID to your .env file like this, to know more about the Notion API key, refer to the [Notion API Docs](https://developers.notion.com/docs/create-a-notion-integration) ``` NOTION_TOKEN=secret_{your_token} ``` Usage ----- [](#usage) That's it! You're all set! The package will take care of the rest. Now you can head over to your GitHub repository, create an issue or a pull request, and you'll see the data automatically synced to Notion. If you wish to change the property names or types, you may continue with the documentation. Additionally, if you want to listen to other events not currently supported by the package, refer to the contribution section and send a pull request. Customization ------------- [](#customization) If you want to customize the property names or types for the databases in Notion, this section is for you. Here's how you can make the necessary adjustments: ### Mapping to Notion Database [](#mapping-to-notion-database) The package maps the data from GitHub to Notion based on a set of transformers. For example, the issue transformer is responsible for mapping the issue data from GitHub to the issue database in Notion, and the same goes for the pull request transformer and the user transformer. You can create your own transformers and map the data as you see fit. However, please note the following: 1. The transformer must implement a specific interface. For instance, for the IssueTransformer, you have to implement the IssueTransformerInterface and then bind your own implementation to the interface in your service provider like this: ``` $this->app->bind(IssueTransformerInterface::class, IssueTransformer::class); ``` 2. Also, note that the database needs to have a text column called ID. This unique ID is used to identify the record in the database, and it is used to update the record if it already exists. So make sure to add this column to your database. 3. The keys of the transformer need to be the same as the base Transformer; they are essentially the property names for the entity. With these changes, you're all set to customize the transformers to your specific needs. For more details on how to map properties to your Notion database, you may refer to the [Laravel-Notion-Integration](https://github.com/Eyadhamza/Laravel-Notion-Integration) Documentation. Contributing ------------ [](#contributing) The package currently supports only issues and pull requests. If you wish to add support for other events, you are more than welcome to do so by sending a pull request. To help you understand how to add support for other events, let's go over the package internals: ### Package Internals [](#package-internals) #### The Webhook Controller [](#the-webhook-controller) The webhook controller is responsible for receiving webhook requests from GitHub. It first runs two middlewares: the VerifyWebhookSignature middleware, which verifies the request signature to ensure the requests are genuinely from GitHub, and the VerifyWebhookEvent middleware, which verifies the event type. The event type is then merged as an Enum "GithubEventTypeEnum" with the payload and passed to the GithubRequest class. #### The GithubRequest Class [](#the-githubrequest-class) The GithubRequest class is responsible for parsing the payload and returning the data in a structured way, such as creating the associated entity and its associated user. #### GitHub Entities [](#github-entities) The package has three entities: Issue, PullRequest, and User. Each entity has its own transformer, responsible for mapping the data from GitHub to the Notion database. The entity also sets the Notion database ID, sets the class attributes based on the request data, and then calls the transformer to map the data to the Notion database. #### The GithubWebhookHandler [](#the-githubwebhookhandler) The handler accepts the GithubRequest and then calls the appropriate action, either creating the page in the database, updating it, or deleting it. ### Implementing a New Event [](#implementing-a-new-event) If you want to add support for a new event: 1. Add the event type to the GithubEventTypeEnum. 2. Create a new entity for the event. For example, if you want to add support for the "push" event, you will create a new entity called GithubPush, extending the GithubEntity class, and then implementing the abstract methods. 3. Create a transformer class and interface for the new entity. Use it in the mapToNotion method and remember to bind the interface to the implementation in the package service provider. 4. Create a test, using the JSON payload to test with, and ensure it passes. 5. Send the PR! Testing ------- [](#testing) You can run tests for the package using the following command: ``` composer test ``` Changelog --------- [](#changelog) For a detailed history of changes to the package, please see the [CHANGELOG](CHANGELOG.md). Security Vulnerabilities ------------------------ [](#security-vulnerabilities) If you discover any security vulnerabilities, please follow our [security policy](../../security/policy) on how to report them. Credits ------- [](#credits) - [Eyad Hamza](https://github.com/Eyadhamza) - [All Contributors](../../contributors) License ------- [](#license) The Laravel Github to Notion Webhooks package is open-source software licensed under the [MIT License](LICENSE.md). --- ### Health Score 24 — LowBetter than 32% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity7 Limited adoption so far Community10 Small or concentrated contributor base Maturity52 Maturing project, gaining track record Bus Factor1 Top contributor holds 90% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Unknown Total 1 Last Release 1024d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/d9cb15eabd6d8e7c3f899d9f176a8cf452db23c406ea7b3cdfcdaf3943ef0ba6?d=identicon)[EyadHamza](/maintainers/EyadHamza) --- Top Contributors [![Eyadhamza](https://avatars.githubusercontent.com/u/65258058?v=4)](https://github.com/Eyadhamza "Eyadhamza (18 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (1 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)") --- Tags laravelPISpacelaravel-github-to-notion-webhooks ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/pi-space-laravel-github-to-notion-webhooks/health.svg) ``` [![Health](https://phpackages.com/badges/pi-space-laravel-github-to-notion-webhooks/health.svg)](https://phpackages.com/packages/pi-space-laravel-github-to-notion-webhooks) ``` ### Alternatives [vormkracht10/laravel-mails Laravel Mails can collect everything you might want to track about the mails that has been sent by your Laravel app. 24149.7k](/packages/vormkracht10-laravel-mails)[spatie/laravel-prometheus Export Laravel metrics to Prometheus 2651.3M6](/packages/spatie-laravel-prometheus)[hydrat/filament-table-layout-toggle Filament plugin adding a toggle button to tables, allowing user to switch between Grid and Table layouts. 6292.3k1](/packages/hydrat-filament-table-layout-toggle)[scalar/laravel Render your OpenAPI-based API reference 6183.9k2](/packages/scalar-laravel)[ralphjsmit/laravel-helpers A package containing handy helpers for your Laravel-application. 13704.6k2](/packages/ralphjsmit-laravel-helpers)[musahmusah/laravel-multipayment-gateways A Laravel Package that makes implementation of multiple payment Gateways endpoints and webhooks seamless 852.2k1](/packages/musahmusah-laravel-multipayment-gateways) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)