Skip to main content

Adding a GitHub webhook

Abstract

You can specify webhooks on Github so that Bitrise automatically triggers a build of your app whenever you perform a specified action, such as a code push or a pull request.

You can specify webhooks so that Bitrise automatically triggers a build of your app whenever you perform a specified action, such as a code push or a pull request. For GitHub, all you have to do is register your bitrise-webhooks URL as a Webhook in your GitHub repository.

You can register a webhook either automatically or manually. This guide walks you through the process of manually registering a webhook.

Admin access only

Only users with the role of admin on the app's team can access all functions of the App Settings page of an app.

  1. Open your app on Bitrise.

  2. On the main page of the app, click on the App Settings icon: settings.svg.

    app-settings.png
  3. On the left, select Integrations.

  4. Click Set up webhooks manually.

  5. In the pop-up window, select GitHub from the dropdown menu.

    apps-webhooks-select.png
  6. Copy the webhook URL.

  7. Navigate to your GitHub repository and select Settings.

    Adding a GitHub webhook
  8. Select Add webhook under Webhooks.

    Adding a GitHub webhook
  9. Paste the GitHub Webhook URL from Bitrise to the Payload URL.

    Adding a GitHub webhook
  10. And on the same page, select Let me select individual events.

    Adding a GitHub webhook
  11. Select Pull request and Push.

    Adding a GitHub webhook
  12. Press the Add webhook button and you're done.