Integration: GitHub

Integrate Ghost Inspector with GitHub

Search our documentation:

Toggle Documentation Menu

Integration: GitHub

If you would like to trigger your Ghost Inspector tests or suites through GitHub, you can do this via their webhooks feature. If you would like the test or suite results integrated into the status of your commits and pull requests, you will also need to activate our Ghost Inspector integration with your GitHub account.

Activate Ghost Inspector's GitHub Integration

To enable GitHub integration for your personal account or organization, go to your account page and click on “Integrations”. You’ll see the GitHub logo under available services.

Note: Enabling Ghost Inspector's GitHub integration is only necessary for sending statuses to GitHub. The scope of the integration allows us to update statuses only. It does not allow us to access your account or repositories.
Ghost Inspector Integrations

Click the “Connect Service” button and follow the instructions. You’ll need to log into your GitHub account. Once GitHub is connected, our API will automatically send statuses to the associated commits when webhooks are triggered (See setup below).


Add Ghost Inspector Webhooks to GitHub

Simply add a webhook pointing to our API and select when you would like it to be fired. You can add as many as you'd like to trigger various tests or suites. To trigger a suite, the API URL would look like this:[suite-id]/execute/?apiKey=[api-key]. (You will need to swap in your own values for [suite-id] and [api-key].)

Note: This example assumes that you want to execute a suite after your project has been pushed. For other options, please see our API documentation.
GitHub Webhooks

If you've activated our GitHub integration above, statuses will automatically be sent to GitHub when these webhooks are triggered.

GitHub Statuses